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GENERAL 


This document defines the Network Definition Language (NDL) for the 
 B1709. $.It is intended to serve as both a formal specification of 
the language and as a programmer's guidee The reader should be 
somewhat familiar with 1) Burroughs Data Communication procedures 
and hardware» and 2) B1700 NOL software system architecture. 


RELATED PUBLICATIONS 


B1790 Data Communications Pineteonal Description 
B17)20 NOL/ZLIBRARY (P.S. 2212 5215). 
B1700 Message Control System (MCS) Manual 
B1790 NOL Reference Manual (C# 1073715) 
DCYZAUDIT Technical Documentation and 
Qoerating Instructions 
B1700 Data Comm Audit (P.S. 2212 5421) 
B1790 RJE/Terminal(NDL) (CP.~S.2 2212 5249) 


The functional description should be read before the NOL Reference 
Manual» Since it describes the overait 81700 NOL system. The MCS 
manual will be of value to anyone who needs the additional features 
of message control system in their Datacomm System. 
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ie laaenehs OF NOL 


NDL is a higher-order language for Data Communications. It provides 
a simple means of generating a B1700 Network Controller (NC). If a 
network is changeds the system can be. quickly and easily 


regenerated by recompiling. A network is defined by specifying in 


NOL source code the network attributes: The physical devices tn the 
network Clines»s terminals» adapters» etce)» the Line discipline to 
be used C"REQUESTS™)» the order and oprtority of Line use 
C"*CONTRILS")» and the grouping of stations into files. 


An NOL orogram consists of the following sequence of sections: 


SICTION | FUNCTION | 
DECLARATION Constants. audit file» and MCS signal 
character definition 
REQJEST 3 Code for line disciplines for each type of 
7 remote device. SEE 
CONTROL Code to decide the order and priority of 
| line use. | | 
TERAINAL Lists the attributes for each type of remote 
pt device 
STATION Lists the attributes for every remote device 


In the network. 


LIN: Lists the attributes for each tine in the 
network . "% | 
FIL Groups stations into logical files 


The NDL compiler transtates the source into two outputs: 


4) The Network Information File (NIF)» a file of tables 
- describing the physical and Logical attributes of the 


network. 


2) The Network Controtler Codefile. REQUESTS and CONTROLS 
| are compiled into code and incorporated as subroutines 
in the codefile. The NIF contains the initializatton 
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values for the controller's line» stations terminal, 
and file tables. 
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CODING AIDS 


2 | NDL source language preparation can be simplified by using’ the 

coding aids provided by the. compiler. Common datacomm_ control 
characters have been predefined. For examples» the symbols "ETX™ and 
"SIX" are recognized by the NDL compiter to signify the hexadecimal 
strings 4703" and 4"02” respectively (See DECLARATION SECTION). 
Most users shoutd find it unnecessary to write their own REQUESTS 
and cCONTROLs=-the source’ language library CS8LI3RARY) contains 
REQUESTs and CONTROLs to handle common line disciplines and Line 
driving techniques. Default definitions (See TERMINAL SECTION) may 
be used in the terminals» station» Lines and file sections to reduce 
the coding required. | 


SYNTAX CONVENTIONS | 


This section describes the Backus-Naur Form (BNF) to define’ the 
syntax af the Network Definition Language. 


hig iieoea pale phos SYMBOLS 


The following metalinguistic symbols will be used in this document: 


< > Left and right broken brackets are used to contain one or 
more digits and/or tletters representing a metalinguistic 
vartable whose definition ts given by a metalinguistic 
formula. | | 


The symbol "::=" means “IS DEFINED AS*™. The metalinguistic 
variable to the left of this symbol its defined by the 
metalinguistic formula on its right. 


{ | The symbol "i" means "OR". It separates alternative. 
definitions of a metalinguistic variable. 
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METALINGUISTIC FORMULAS 


Metalingutstic symbols are used in forming a metalinguistic formula. 
A metalinguistic formula is a rule which witl produce an allowable 
sequence of characters and/or symbols. These formulas are used _ to 


define the syntax of the 81700 Network Definition Language. The 


Syntax» combined with the semantics contained in this product 


specification» defines the B1700 Network Definition Language. 


Any mark or symbol in a metalinguistic formula which ts not one of 
the metalinguistic symbols» ts equivalent = to itself. The 
juxtaposition of the metalinguistic variables and/or symbols in a 
metalinguistic formula denotes the juxtaposition of those elements 
in the construct indicated. | 


An examole of a metalinguistic formula is: 


<IDENTIFIER> i222 <LETTER> i epnenr Tete Rs <LETTER> |( 
|  <IDENTIFIER> <OIGIT> | 


This metalinguistic formula is read: 


An Identifier is defined as a tetters or an identifier 
followed by a letters» or an identifier followed by a digit. 


The metalinguistic formula above defines a recursive relationship by 
which a construct called an [dentifier may be formed. That 1SP 
evaluation of the formula shows that an Identifier begins with a 
letter. The tetter may stand alones» or may be fotlowed by any 
sequence of letters and digits. 


= ee 


eal | 


BURROUGAIS CORPURATION COMP ANY CONF LDENTIAL 


COMPUTER SYSTEMS GROUP B1700 NETWORK DEFINITION LANGUAGE 
oe BARBARA PLANT PeS-e. 2212 5223 


BASIC ELEMENTS) OF die LANGUAGE 


CHARACTER SET 


The NOL character set is drawn from EBCDIC graphics,» but any EBCDIC 
character is valid in an <EBCDIC STRING>.- The Datacomm System 1s 


internally EBCDIC. Where appropriate all characters are translated» 
as for examples when transmitting to a NON-EBCDIC device. These 


subsets of EBCDIC characters will be used in the following SNF: 


<EBCDIC CHARACTER>::= <LETTER> 
| | 1 <DIGIT> 

1 <SPECIAL CHARACTER> 
| <SLASH> 
1 <VERTICAL BAR> 
1 <BLANK> 

<LETTER> 2 t= oe AIBIC1...1XIVIZ 

—<OIGIT>3:= OlLlee~- 1819 

<SPECIA. CHARACTER>: == -{CSLASH>ICUDIS1etStetct>tetzia 

° | ICLtHU=ISVERTICAL BAR> I" I<BLANK> 
<SLASH>22= / 


<VERTICAL BAR> >2t= | 1 


<BLANK> 2 = > | (ONE GRAPHIC SPACE - HEX 40) 
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BASIC COMPONENTS 


The prinitives of the NOL language. 
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<BASIC COMPONENT>:5= <IDENTIFTIER> 

| <INTEGER> 
<STRING> | 
<OPERATOR> 
<LOGICAL VALUE> 
<BRACKETS>~ 
<SEPARATOR> 
<ASSIGNER> 
<VARIABLE> 


IDENTIFIERS 


<LETTER> | 
| <IDENTIFIER> <LETTER> 
| <IDENTIFIER> <DIGIT> 


<IDENTIF LER>? 


RESTRICTIONS: A) There is no maximum on Identifier Length» but 
| | onty the first 10 characters with be used by the 
comptter.. ; 


B) Identifier must be unique Ci.e.Two REQUESTs may 
not have the same Identifier). 


INTEGERS 


CINTEGER@>2? | -<DIGIT> | 
| 4 <INTEGER> <DIGIT> 


Integers are Loaded as 24-bit binary numbers. 
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STRINGS 

SYNTAX: 

<STRING>2:= | <HEXADECIMAL STRING> 
| : | ! <EBCDIC STRING> 

<HEXADECIMAL STRING>3:= 4™<HEX CONCATENATION>” 

<HEX CONCATENATION>2:= - <HEX CHARACTER> <HEX CHARACTER> 


1 <HEX CONCATENATION> <HEX CHARACTE R> 
<HEX CHARACTER> 


NOTE = 4EX CHARACTERS ARE ADDED BY TWOS. 


<HEX CHARACTER>::= —  <DIGIT> fALBICIDIEIF: 
<EBCDIC STRING>::= — -®@<EBCDIC CONCATENATION>* 
<EBCDIC CONCATENATION>:?: = <EBCDIC CHARACTER>. ) 
ae | <EBCDIC CHARACTER> <E£BCDIC 
CONCATENATION> 


SEMANTICS: 


Any CBC)IC character may appear in an E8CDIC stringe An internal 


quote is represented by two consecutive quotes. For example: "“"""" 


represents an EBCDIC string of one single quote. The maximum length 
of a Hexadecimal string is 40 bits» or 10 Hexadecimal digits. 
Maximum length of a EBCDIC string is 40 characters. 
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OPERATORS 


<OPERATIR>s:=. 


<UNARY JPERATOR>: 2= 


<BINARY OPERATOR>::= 


<LOGICA. OPERATOR>::= 


<RELATLINAL OPERATOR>?::= 


SEMANTI2S: 


Operators are used _ in 


‘<ARLTHMETIC OPERATOR>? == 


expressions 
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<UNARY OPERATOR> 


| <BINARY OPERATOR> 


+ j - | NOT 


<ARITHMETIC OPERATOR> 


<LOGICAL OPERATOR> 


RELATIONAL OPERATOR>~ 


# | - € * t <SLASH>. 


AND 1 OR 


FQ 1 NE 1 Gl t GE ttt tle 


operators require two operandss as in 710 * 35 


only ones as in "NOT BREAK™. The alphabetic relational 


are abbreviations: 


EQ 
NE 
GT 
GE 
LT 
LE 


‘Equal 
Not Equal. 
Greater Than 


Greater Than or Equal 


Less Than 


Less [Than or Equal 


(See EXPRESSIONS). 
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LOGICAL VALUES 


<LOGICA. VALUE>::= 


SEMANTIZS: 


TRUE 


COMPANY CONFIDENTIAL 
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FALSE 


5223 


TRUE is equivatent to the integer ls» and FALSE to 0. For example the 


expression "BREAK E£@ TRUE™ could have been “BREAK £Q 1". 


7 2-6 
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BRACKETS 


SYNTAX: 


<BRACKET>:2:= — (1)tt 4d] 


SEMANTICS: 


Parentheses normatly signify a modification or variant form of the 
precediag symbol» for example "TRAN CTRANSMIT)™ and "TRAN 
CRECEIVZ)". True brackets are used for subscripts of TOG and TALLY. 


SEPARATORS 


<SEPARATOR>: = | | » tet? 1 <SPACE> : 


<SPACE>22= <BLANK> § <SPACE> <BLANK> 


SEMANTI2S: 


Note that one blank or any number of blanks may be used to separate 
basic camponents. These statements are equivalent: 


is MYUSE=INPUT,OUTPUT. 
26 MYUSE = INPUT» QUTPUT. 
3. MYUSE 

INPUT 

: | 

‘OUTPUT 
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ASSIGNE 


SYNTAX: 


i 


CASSIGNIR>St= t= 1 <VERTICAL BAR> 


SEMANTICS: 


eau 6 


81700 NETWORK DEFINITION LANGUAGE 


The <ASSIGNER> is used in assignment statements in the REQUEST and 


CONTROL secttonse Example: | 


TOGLO}]. 2= TRUE. 


‘ene 
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scbipintchcd 
peediad 
<VARTABLE>23= | | <SYSTEM STATUS VARIABLE > 


<ERROR FLAG> 
<USER TOGGLE> 
<USER TALLY> > 
<STRING FUNCTION> 


SEMANTICS: 


NDL pravides no means of declaring data areas Like COBOL'*s 
"WORKING"“STORAGE™ or UPL/SDL's “DECLARE™. In the REQUEST and 
CONTROL sections» the NOL programmer must use a set of predefined 
identifiers to test or set the value of system ttemse All of the 
variablas may appear in an expression in either Cor tn some cases» 
both) REQUESTs or. CONTROLs. Andout half of the variables may have 
their value changed explicitly in a REQUEST or CONTROLs that is,» 
they may appear on the left side of an <ASSIGNER> in an assignment 
statement. The remainder are read onty- See the following table as 
to where a specific variable can be referenced and whether it can 
be assigned. , | 


except for "TIME"» system status variables refer to items in the 
Network Controller's Liner station» or terminal tables. “TIME™ Is 
an MCP communtcate. 


2-9 


BURROUGIS CORPORATION — COMPANY CONFIDENTIAL 
CUMPUTER SYSTEMS GROUP 81700 NETWORK DEFINITION LANGUAGE 


SANTA BARBARA PLANT | P.S. 2212 5223 


VARIABLi? | 7 ASSIGNABLE SIZE IN 
3 | | (CYES=*) | | BITS: 


SYSTEM STATUS VARIABLES: 
CHAR. CHARACTER 7 eo 8 
FREQUENCY CINPUT) a 8 
FREQUENCY (OUTPUT) | | 8 
LODESC : he 1a = 288 
IN? UTATTACHED | | 1 
QUTPUTATTACHEO - | - 1 
LENGTH CINPUT) | | 12 
LENGTH (OUTPUT) a 7 | 12 
LINE | | | 8 
LINE (CONTROL KEY) 7 | 5 
LINE (QUEUED) nn : 1 
MAXSTAT IONS | _ a 10 
RE SULTDESC 7 | 2h + 24 = 48 
RETRY | | ae Oo 8 
STATION 7 | | * (CONTROL ) 40 
STATION CENABLED) + 4 
STATION CHYUSE) we | 
STATION CQUEUED) 7 - | 1 
“STATION CREADY) BS 1 


STATION CTYPE) BS e: 


2= 10 
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VARIABL=? ASSIGNABLE: SIZE IN 

| CYES=«#) BITS: 


SYSTEM STATUS VARIABLES (CONT.) 


TERMINALTYPE | | 6 
TIME ee 20 
TRAN CRECEIVE) ¥ | B+16>24 
TRAN (TRANSMIT) 7 | eo | | Br 1624 
ERROR F_AGS: | | 
ADJERR | * 1 
BREAK | ) eo 1 
ACCESSERR os | ot 
ENIFBUFFER a | 1 
EXCEPTION * a 1 
FORMATERR . | - 4 
LOSSOFCARRIER Ss | : 1 
LOSSOFOSR ) * 1 
PARITY : of | 1 
Tr4eour es * 3 |. ' 
TRANERR ee | . s**a : 1 


USER TOSGLES: 
TOS C<INDEX>] © te a _ #4 


LINE (TOG C<INDEX>}) 0 _ 32 we 


Rat eee) fe 


ed se SE eS a a ee) 


BURROUGAS CORPORATION 


COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


VARIABL=: 


USER TALLIES: 
TALLY [ <INDEX>1. 
LIVE (TALLY C<INDEX>) 
TEWE (TALLY) 
STRING =UNCTIONS?. 
CUNVERT 


DECIMAL 
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ASSIGNABLE:  — | SIZE IN 


 CYES=*) BITS: 
ke 8 
* 8 
#19. 
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SYSTEM STATUS VARIABLES 


SYNTAX: 


—<SYSTEM STATUS VARIABLE>::= CHAR 

| CHARACTER 
FREQUENCY CINPUT) 
FREQUENCY COUTPUT) | 
IODESC 
INPUTATTACHED 
QUTPUTATTACHED 
LENGTH CINPUT) 
LENGTH COUTPUT) 
LINE 
LINE CCONTROL KEY) 
LINE CQUEUED) 
MAXSTATIONS 
RESULTDESC 
RETRY 
STATION | 
STATION CENABLED) 
STATION CLINE) 
STATION (MYUSE) 
STATION CQUEUED) 
STATION CREADY) 
STATION (TYPE) 
TERMINALTYPE 
TIME 
TRAN CRECEIVE) 
TRAN CTRANSMIT) 
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SEMANTICS: 


CHAR» C4ARACTER 


Both names refer to the same thingr the character registerr a 
one-byte field in the line table. Assignable» it ts intended to be 
used in REQUESTs while processing a message character by character. 
The "FETCH™ statement toads the register. For example: 


DO ECHGLOOP FOREVER. 

FETCH CHAR. | 

TRANSMIT CHAR. 

IF CHAR EQ ETX THEN UNDO. | 
END ECHOLOOP. 


FREQUENDY ela eae FREQUENCY COUTPUT) 


These eight~bit read-only items in the station table are accessible 
onty by CONTROLs and are dectared by the user in the <FREQUENCY 
STATEMENT> in the STATION section. | 


eee PO et oar WB als PE igs OE COS Ek ARE RS le, Sede POS at i 
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LODESC 


288-bit read-only field in tine table. Accessible only in REQUESTS. 
[ODESC contains the two 144-bit I/0 descriptors used for I/0 on the 
current line. Useful in debugging» probably in <AUDIT STATEMENT>. 


INPUTATTACHED 


OUnerbit flag in Line table. Not assignable> accessible only tn 


REQUESTs- INPUTATTACHED is set true 1f there ts a valid input 
message buffer into which data may be received» false if no input 
message buffer is attached to the Line. 


OUTPUTATTACHED 


Onerbit flag in line table. Not assignable» accessible anly in 


REQUESTs. OUTPUTATTACHED is set true if there is a valid output 
message buffer attached to the line for transmissions false _ if 
there is no output message buffer attached. : : 


LENGTH CINPUT)» LENGTH CQUTPUT) 


Two 12-bit read-only fields in the Line table. Accessible only in 
REQUESTs. The tength in bytes of the input or output text 


respectively. It does not include the header length or ETX. 


LINE 


-Eight-bit item in Line table which stores the current lLine-numbder. 
readronly» accessible by both REQUESTS and CONTROLS. _— 


a RNs dle Ee kc Ea, 2 Da as St Pale ET NL eg 0S ly 2 Stal Sane LS | ea 
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LINE (CONTROL KEY) | 


Five-bit» read-only item in line table. This item is accessible only 
in ‘SONTROLS» and it should be used to drive the "FLOW OF cCONTROL* 

in a TONTROL (See CONTROL SECTION)» probably as a CASE STATEMENT 

INDEX. The value of LINE CCONTROL KEY) gives the reason that the NC 

entered the CONTROL. To some extent» the value dictates the action 

that the CONTROL should take. 


The Values: 
0. Line is not busy. I/0 may be initiated. 


i. Change in status of a station or stations on 
this. line. This occurs in the following cases: 


A) First time through CONTROL. 
B). Remote file open/close involving a station on 
this Line. / | | 
Cc) NC EQJ initiated - all stations disabled for 
| input. na | | : 
0D) TERMINATE ERROR has caused a station to go not 
ready. : | 


The CONTROL should rebuild the poll List» if any (See 
Initiate Autopoll)» or retest the stations on the 
line. If no stations are eligible for I/0» the 
CONTROL should initiate idle. : | 


‘ee An output message has been queued for this line» but 
the line is now tn a read with no timeout or waiting 
for ring. CONTROL must resolve the conflict by: 


a) INITIATE CANCEL which kitts the read» or 
by) CONTINUE ahich leaves the read in progress and 
the output message in the queue. 


3. A ring complete has been received. Used for switched 
Lines only. | — 
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The last REQUEST on this tine did a TERMINATE 


GUTPUTCRETURN). The CONTROL must restart ait oby 


eventually 


executing a CONTINUE. The CONTROL may at 


this point change the value of STATION before 


returning 


in some disciplines. 
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LINE C(QJEUED) 


One-bit flag tn Line tables read-only» accessible to CONTROLS = and 
REQUESTs.e. True if a message is queued for output for any station on 
this line. 7 


MAXSTATIONS 


The maximum number of stations on the current Lines including 


passive stations. read-only» accessible only in CONTROLS. Its value | 


is specified by the <MAXSTATIONS STATEMENT> tn the Line section. 
Normally used to test the current value of Sean to see if it 
should de reset to one: 


IF STATION FQ MAXSTATIONS 
THEN STATION:= 1. 
ELSE STATION: =STATION#1- 


-RESULTD=:SC: 


48-bit Gadeonty field accessible in REQUESTS. It consists of the 


24-bit result descriptors in the two I/0 descriptors kept for each 
line in the line table. RESULTDESC references sub-fields of 
"TODESC™. Useful in debugging a datacomm system (Cas in “AUDIT 
TRACEFLZL CRESULTDESC).™) 


RETRY 


Eight-bit TALLY intended to be used to count receive or transmission 


retries in REQUESTs. After each unsuccessful attempt» subtract one 
from R=TRY.~ When RETRY equals zeros a TERMINATE ERROR would be 
appropriate. Assignable and accessible in both REQUESTs = and 
CONTROLS- The tnitial value of retry 1s set by the <RETRY 
STATEMENT> in the station section. It may be reset to this vwatue at 
run-time oy INITIALIZE RETRY in REQUESTs. CIt is never implicitly 
reinittalized by the NC). . | | 
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STATION 


LO-bit field in tine table» assignable by CONTROLs» read-only by 
REQUESTs. It contains the current station number on this” tine. 
STATION must be greater than or equal to ones and it may never be 
greater than MAXSTATIONS. A fatal run error wilt occur if STATION 
exceeds these bounds» so the NOL programmer should always test the 
vatue. of station before tncrementing it. (CSee MAXSTATIONSs also 
CONTROL section). STATION numbers are determined by the order of 
stations in the <LINE STATION STATEMENT> in the Line section. Note 
that STATION refers only to the LlLine-relative station number. It is 
not the same as the “logical station number™ which appears in the 
27“-byte message header. “Logical station number” is unique to each 
station in the systems regardless of which line it is on» and is 
determined by the order tn which stations are declared tn_ the 
Station section. Neither is STATION the same as the "file~relative 
station number™ which is used as a key by user programs tin doing 
I/0 or remote filess Neither “logical station number" nor | 
"filerrelative station number* are referenceable within NDL. 


STATION (MYUSE) 


2<bit» read-only item in the station table» accessible onty in 
CONTROLs. [Its value is assigned by the <MYUSE STATEMENT> in the 


station secttons as follows: 


1. Station 1s Input only. 


2e Station 1s output onty. 
36 Station is used for input and output. 


The eetauTt value is Be 
STATION (ENABLED) 


Onewbit» read-only flag in station table. Accessible by CONTROLs. 
"STATION CENABLED)™ must be true if 1/0 is to be initiated by the 
CONTROL for this station (See CONTROL INITIATE STATEMENT)- Set in 
the station section by <ENABLETNPUT STATEMENT>» but can _ be 
overridden by the MCS. | 
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STATIONCLINE ) 


Eight-bit» read-only entry in the station table ahich indicates the 


line index of the Line currently associated with the station in a 
switched-Line environment. Set when a line CONTROL does an initiate 
Cinput» output» input-output» output»input) and reset to zero on an 
initiat2 disconnect» terminate disconnect» or terminate retease 
station. STAFIONCLINE) should be used in a CONTROL to determine if 
a station is assigned to another tine or the current tine or» 1f 
zero» unassigned. 


STATION CQUEUED) 


One bit» read-only. Accessible by both REQUESTs and CONTROLs. True 
if current station has at teast one message in its output queue. If 
false» INITIATE OUTPUT is invalid in CONTROLs for this station. 


One-pit» read-only flag in station table. Accessible by CONTROLS. 
Must be true in order to initiate I/0 in CONTROLS (See _ IF 
STATEMENT). “Station can be marked not ready by MCS. If an MCS is 
presents» TERMINATE ERROR marks a station not ready. 


STATION CTYPE) | 


Tworpit read-only field accessible in both REQUESTS and CONTROLs. It 


represents the master/stave type otf the remote device currently 
indexed by STATION. | 


Possible values: 


ole Stave statton 


Le Controller station 


5% Normal station 


See the <CONTROLLER STATEMENT> tin the station section for 


‘information on setting this variable. STATION (TYPE) should be used 
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in building potl strings (See <POLL STATEMENT>) to ake advantage 
of group Pape | 


TERMINAL ve 


Six-bit read-only field in terminal table. Value is set by the 


TERMINAL TYPE statement tn the terminal section. 


TIME 


20-bit field giving the time of day in tenths of a second since 


midnight. Invoking TIME at run-time loads the value directly from 


the system clock. Used to load TIME (TALLY) for message headers: 


TIME CTALLY) z= Time. 


TRAN CRICEIVE) 


B» 16» or 24 bit field kept in the station table to hold the 
transmission number of input messages. Assignable and accessible in 
REQUESTs. Normatly loaded from the internat message header by 
RECEIVE TRAN. After RECEIVE TRAN» TRANERR wil pe set 1 f this 
transmission number equals the last transmission numbere- Length is 
set in terminal section by <TRANSMISSION NUMBER STATEMENT>. Set to 
zero by “INITIALIZE TRAN CRECEIVE)". | 
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Qutput message transmission number. TRANCTRANSMIT) can be = assigned 
directly in REQUESTs CTRANCTRANSMIT):= Decimal (TALLYCO]» 3).) or 
set by the NC by specifying INITIALIZE TRANCTRANSMIT). At BOJ timer 
TRANCTRANSMIT) is set to binary zeroes,» so it should be reset 
before sending it. Normally it should be given a value different 


from the value of the last output transmisston numbers, either by 


the REQJEST or by the MCS. Not referenceable in CONTROLS. 


BURROUGIS CORPORATION. 


COMPUTER SYSTEMS GROUP 


SANTA BARBARA PLANT 


ERROR FLAGS 


SYNTAX: 


<ERROR “LAG>2:= 


<RECEIVE ERROR FLAG>::= 


<TRANSMIT ERROR FLAG>:2= 


<ITEM E2ROR FLAG>::=. 


SEMANTIZS: | 


Alt error flags are one~bit_ 


REQUESTs. ENDOFBUFFER is 
accessidie in CONTROLS too. 


once 


COMPANY CONFIDENTIAL - 
81700 NETWORK DEFINITION LANGUAGE 


<RECEIVE ERROR FLAG> 
<TRANSMIT ERROR FLAG> 
<ITEM ERRO@Y FLAG> 


PARITY 

ACCESSERR 
TIMEOUT 

BREAK 

LOSSOFCARRIER 

EXCEPTION 


BREAK 


LOSSOFDSR 
TIMEOUT 
EXCEPTION 


ADDERR 
TRANERR 
FORMATERR 
ENDOFBUFFER 


fields» assignable and accessible in 
the onty error flag assignable = and 
Alt error flags are reset by the NC 


before initiating I/0- Each 1s automatically set on the occurrence 
of the appropriate error state. In input REQUESTs the error flags 


header. : 


are moved to the read-error field in the 27“*byte internal message 


ee 


iN] 
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 ADDERR 


Set on input from a station when an error in the station address is 


detected. The size and value of the station address as defined in 
the <TERMINAL ADDRESS STATEMENT> and <STATION ADDRESS STATEMENT> 


allow the Network Controller to check the correct value against 


that which is received. 


ACCESSERR 


Set if the MLC/SLC was not granted memory access before the next 
character was received on the Lines destroying. the previous 
character. | 


BREAK 


A BREAK signal was received from the remote station during output. 


COMPUTER SYSTEMS GROUP 


ENDOFBUFFER 


set on & conditions: 


2-24 


‘BURROUGIS CORPORATION | | COMPANY CONFIDENTIAL 
; B1700 NETWORK DEFINITION LANGUAGE 


SANTA BARBARA PLANT Pe Se 22120 «5223 


l. In an input REQUEST» the number of characters. 
stored in the buffer exceeds the maximum — 
specified by the <MAXINPUT STATEMENT> in the 
terminal description. | 

2- In an output REQUEST» the transmit I/0 reached 
the end of the message without encountering a 
terminating character (e.«g- ACK» NAK» ENQ> ETB» 
EQT» ETX for TC500). 

3. In input REQUEST» the number of | FETCHed 


characters exceeded the number actually in the 


buffer. 


Ge In a CONTROL» polt List too long. 


EXCEPTIIN | 


Set true if parity» ACCESSERR» ENDOFBUFFER> 


TIME QUT, BREAK» 


LOSSIFCARRIERs» or LOSSOFDSR is set because of an initiated I/0. 


 FORMATERR 


Set if an NDL REQUEST uses the RECEIVE <string> 


option to check 


input data» and the characters received do not correspond to the 


<string> specified. 


ie oT SEU re Ee Se See SEE a ee ed ee 
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LOSSOFCARRIER 


Set if hardwarer specifically the data set» reported LOSSOFCARRIER 


frequency. 
LOSSOFISR . 


Set if hardware reports that data set ready was dropped during an 
170 | | 


PARITY 


Set when parity error or BCE error is detected while receiving a 
sme ssa Ie* | | 


TIME OUT 


A charazter was not received (on input) or the first character was 
not transmitted within the time specified by the adapter. 


_TRANERR 


After P2ECELVE TRANCRECEIVE)", the transmission number received was 
equal to the number in the last message from the same station. 


ETE eR eA =F rag ey See tt Be eee ae Ge ot eee See od SOS WEEE es SEP Ee ee 2 a. ‘Ela yierere et sagan abe tetris ste Sharan 5: 3! 
aia eats ee ae te esas habe ote ei ree ana We ee et ett eS Tmo ea tere eric Se SEH Ee sic ae Sees 


Let RR ree 


asta 
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USER eee: 


SYNTAX: 
<USER TIGGLE>::= | — TOGE<TO0G INDEX>1 

| LINECTOG CTOG INDEX]) 
<TOG INJEX>22= | <INTEGER> | <VARIABLE> 
SEMANTI> $2: 
TOG 


A variaogle number of onesbit fields in the station table can be 
reserved for programmer use. They are assignable and accessible by 
both RZQUESTs and CONTROLs» but are more useful to REQUESTs = since 
there tis one set of TOGs for each station. They must be set by 
either an <ASSIGNMENT STATEMENT> or by an <INITIALIZE STATEMENT>. 
TOGs are useful as tocal data or for communicating with the MCS. 
TOGLO“7] are automatically loaded in the 27/-byte internal header of | 
any message queued for the MCS or user program (Cincluding error 


messages: eege “TERMINATE INPUT™ or "TERMINATE ERROR™). TOGGLES Can 


be reloaded from the header of an output message by INITIALIZE TOG 
{[<INDEX>]. 
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LINECTOS) 


A variable number of assignable one~bit Prsias: in the aie: table can 
be reserved for programmer use. Other than locations Line TOGGLES” 
are similar to station TOGGLES. 


RESTRICTIONS? 


1) A "MAX" statement in the declaration section 
must preceed any TOGGLE indexed by a variable. 


2) No more than the absolute maximum of 100 Line 
| TOGGLES and 100 station TOGGLES may be used. 


3) TOGGLE indices start at Q and proceed 
~—~sequentiatly.. : 


4) In the event a "MAX" statement is not used the 
number of TOGGLES will be determined by the 
largest index used. 
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USER TALLIES 


SYNTAX: 
<USER TALLY>2:= TALLY £<TALLY INDEX>] 
1 LINE (TALLY C<TALLY INDEX>]) 
1 TIMECTALLY) 
<TALLY INDEX>22= | | <INTEGER> 1 <VARIABLE> 
‘SEMANTICS: 
TALLY 


A variadle number of eight-bit fields in the station table which can 
be reserved for programmer use. Assignable and accessible in both 
REQUESTs and CONTROLs- They must be set by either an <ASSIGNMENT 
STATEMENT> or an <INITIALIZE STATEMENT>. Useful as tocal data _ or 


MCS c3immunication CTALLYL0~2] will be transported in the 2/7/-~byte 
internal header). 


LINECTA- LY) 


A variable number of eight=-bit fields in the Line table which can be 
reserved for programmer use. ASSignable and accessible to both 


REQUESTs and CONTROLs. 


TIMECTALLY). - 


20-bit field in station table» assignable and accessible onty tn 


REQUESTS. Normatly assigned the vatue of "TIME" in input REQUESTs. 
Moved by the NC to the internal message header on a *RECEIVE TEXT". 


TIMECTALLY) is subject to the same restrictions as user TALLIES. 
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STRING FUNCTIONS 


SYNTAX: 
<STRING FUNCTION>: == - <DECIMAL FUNCTION> 

— - <CONVERT FUNC TION> 
<DECIMAL FUNCTION>::= © DECIMAL (<EXPRESSION>» <INTEGER>) 


CONVERT (C<EXPRESSION>) 
1 CONVERT (C<EXPRESSION>>1) 


Ht 


<CONVERT FUNCTION>:: 


SEMANTICS: 


The <DECIMAL FUNCTION> is identical to the SOL/UPL “"DECIMAL™. It 
converts the value of the <EXPRESSION>» treated as a binary number» 
to an :BCDIC string of decimal digits of tength <integer>.- For 
example, DECIMAL (4"FF"» 3) is converted to the string "255"» or 
4G" F2F5F5™. DECIMAL returns a maximum of eight characters even if 
the value of <integer> is greater. If the value of the <expression> 
exceeds 24 bits only the lowcrorder 24 bits is used. 


The <CONVERT FUNCTION> converts binary strings of any length to 
character strings. If "51" is specified then one character i15s 


generated for each bit (€"0" for binary O» "1" for binary 1). =The 
default is 4 bits to one character (CHexadecimal conversion). 
Leading zeroes will be supplied to fill out leftmost Hexadecimal 


positionss if necessary. For example: | 
1) CONVERT €255-1) = "000000000000000011111111" 


2) CONVERT (255) = "O000FF™ 
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EXPRESSIONS 
SYNTAX: 
<EXPRESSION>s23= | | ; <TERM> 


i <TERM> <BINARY OPERATOR> <E XPRESSION> 
1 <EXPRESSION> <BINARY OPERATOR> <TERM> 


<TERM>ss= | | <PRIMARY> | 
—  § <UNARY OPERATOR> <PRIMARY> 


<PRIMARY>:2= C<EXPRESSION>) 
| | <VARTIABLE> 
<CONSTANT [DENT IF TERS 
<STRING> 
<INTEGER> 
<LOGICAL VALUE> 


<CONSTANT IDENTIFIER>::= (SEE CONSTANT DECLARATION) 


SEMANTI® 33 


Expressions are used in the REQUEST and CONTROL sections in various 
statements. Note that no distinction is made between Logical and 
arithmetic expressions. Since REQUEST and CONTROL code is executed 
on the SDOL7Machine» expressions Like 


CTRUE + 10 NE DISCONNECT) * TALLYCO] 


are syntactically legal and wilt execute without runctime errors. 
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OPERATOR PRECEDENCE: 


Eek Reps te se: OOcs a tek Sa ee eae PS CE A ek 9 ASS Ae ob ae Sl ci FOE Pea a a i ced bad NE 1 Fo ORE Ss a ake gs ce ew og 5 


If there are no parentheses to guide evaluation of an expression (as 
in "TRJE + 10 NE DISCONNECT)» operator precedence determines’ the 
order of evaluation. Two rules are used: (1) equat precedence 
operators are evaluated from left to right» and (2) higher 
precedence operators are evaluated first. From highest to lowest» 
the precedence order i158: | 


unary +» siseyeceaual sreeedences 
*»s <SLASH> 

binary +t» binary~ 

LTp LE» EQ» NE» Gly GEe =» < > 
NOT 

AND 


OR 


For exanple “TRUE + 10 NE DISCONNECT * 3" is evaluated as if it had 
been written "“CTRUE + 10) NE CDISCONNECT * 3)" | 


EXPRESSION eae LENGTH: 


If no binary operator was used» the Length of the value left on the 
value stack after expression evaluation is equal to the length of 
the primary Ci.e. 24 bits for <integer>» 1 bit for “TRUE"» etc). 
Logical binary operators ( AND» OR) return values whose length is 
equal to the ltonger of the two operandss arithmetic operators 
return 24~bit values. | | 
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SECTIONS OF AN NE PROGRAM 


SYNTAX: 


<NETWOR{ DESCRIPTION>: 3:= <DECLARATION SECTION> 
| <REQUEST SECTION> 
<LINE CONTROL SECTION> 
<TERMINAL SECTION> 
<STATION SECTION>. 
<LINE SECTION> 
<FILE SECTION> 


SEMANTICS: 


The sections of an NOL program Must appear in the above order. All 
sections are required. | | | 


0 a A ee lS tee Te i ie Se ile de tt Ta ae oe, 
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DECLARATION SECTION 


SYNTAX: 
<DECLARATION SECTION>::= | DECLARATION: <OECLARATION LIST> 
<DECLARATION LIST>?2= <DECLARATION> 
_ | <DECLARATION LIST> <DECLARATION> 
1 <EMPTY>. 
 <DECLARATION>:2= <SIGNAL DECLARATION> 
| <AUDITFILE DECLARATION> 
1 <CONSTANT DECLARATION> 
1 <NIF NAME DECLARATION> 
1 <MAX TALLY/TOG DECLARATION> 
SEMANTIZS: 


The declaration section provides a means of specifying global 
definitions for the user's Network Controller. = 


“SIGNAL DECLARATION 


SYNTAX: 
—<SIGNAL DECLARATION>=::= SIGNAL = "<SIGNAL CHARACTER STRING>*. 
<SIGNAL | 

CHARACT=R STRING>?2= <EBCDIC CHARACTER> 


1 <EBCDIC CHARACTER> <EBCOIC CHARACTER> 
1 <EBCDIC CHARACTER> <EBCDIC CHARACTER> 


<EBCDIC CHARACTER> 


he 


eens Pes ella: Sok Se OF BL 
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SEMANTICS: 


Signal defines up to three one~character prefixes to be used in 
Station-To~Station MCS communication. Any messages that have text 
beginning with one of the signal characters are queued 
automatically by the NC for the MCS. This is true even if the MCS 
has chosen not to participate in user program-remote fite [/0» and 
this station is in the remote file. _? 


BURROUG4S CORPORATION 


COMPUTER SYSTEMS GROUP 


J SANTA BARBARA PLANT 


AUOTTFILE seems lees 


‘<AUDITFILE DECLARATION>::= 


<FILE ATTRIBUTE LIST>: == 


<FILE ATTRIBUTE? := 


<LABEL PART>::- 


<FILE NAME>??= 


 <FILE-[D>» <FAMILY= 
ID>» <PACK“ID>::= 


é : 
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AUDITFILE <AUDITFILE IDENTIFIER> 


C<FILE ATTRIBUTE LIST>). 


<FILE ATTRIBUTE> 


<FILE ATTRIBUTE>» <FILE ATTRIBUTE LIST> 


<LABEL PART> 
<DEVICE PART> 
<BUFFERS PART> 
<VARIABLE PART> 
<SAVE PART> 
<RECORDS PART> 
<AREAS PART> 
<EMPTY> | 


LABEL = <FILE NAME> 


<FAMILY-ID> | 
<FAMILY-ID> <SLASH> <FILE-ID> 
<FAMILY“ID> <SLASH> <FILE-ID> <SLASH> 
<PACK-ID> <SLASH> <FAMILY~ID> 


 CSLASH> <FILE*ID> 


<EBCDIC STRING> 


NOT= = 210 CHARACTER MAXIMUM ON EACH ID. 


BURROUGIS CORPORATION 
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Be <DEVICE PART>::= 


<DEVICE SPECIFIER>::= 


Ce <BUTFERS PART>33= 


De. <VARIABLE PART>2:= 


NOTE = VARIABLE“LENGTH 


Es <SAVE PART>2:= 


COMPANY CONFIDENTIAL 7 
B1700 NETWORK DEFINITION LANGUAGE 


PeSe 2212 


5223 


DEVICE = <DEVICE SPECIFIER> 


DISK 
DISKFILE 
DISKPACK 
DISKCARTRIDGE 
TAPE 

TAPET 

TAPES 

TAPEPE 
PRINTER 


PRINTER BACKUP 


CANY DISK) 
CHEAD PER TRACK) 
(CENTURY-TYPE) 
CCAELUS“TYPE) 
CANY TAPE) 
(7-TRACK) 
C9-TRACK) 
CPHASEENCLOSED) 


PRINTER OR BACKUP) 


BUFFERS = <INTEGER> 


VARIABLE 
RECORDS 


SAVE = <INTEGER 


NOT= = NUMBER DAYS TO SAVE FILE 


Fe. RECORDS PART>::= 


<REZSORD SPECIFIER>:2= 


RECORDS = <RECO 


<RECGRD LENGTH> 


1 <RECORD LENGTH> 


<INTEGER> 


<RECORD LENGTH>::= 
<BLICK LENGTH>::= <INTEGER> 


NOT= = LENGTHS ARE IN BYTES. 


Ge <ARZAS PART>22= 


<NUYBER AREAS>::= 
<BLOCKS PER AREA>::= 
NOT= - DISK FILES ONLY 


AREAS = <NUMBER 
<SLASH> <BLOCKS 


<INTEGER> 
<INTEGER> 


> 
RD SPECIFIER> 


<SLASH> <BLOCK LENGTH> 


AREAS> 
PER AREA> 


OS eet 


PP os be EE Ee PE OS Sa ee 
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SEMANTICS: 


Auditfites are used in <AUDIT STATEMENT>s in the REQUEST section. A 
maximum of three auditfiles may be declared. Any auditfile may be 
referenced in any REQUEST.» As far as the MCP is concerned» 
auditfiles are simple sequential files opened output by the user's 
NC. As such they may be modified at BOJ time by means of label 
equation ("?FILE™ cards). The internal file name is the <AUDITFILE 
IDENTIFIER>. Default file attributes are device = disk» tabel = 
<AUDITFILE IDENTIFIER>» buffers = 1 Cunbuffered I/0 ts impossible 
under MCP control)» fixed-length records» save = 30 days. If device 
type is disk then records = 1800/1» areas =. 40/100 (4000 record 
maximum). if device type is TAPE» RECORDS = 180/1. If device type 
1s PRINTER» RECORDS = 1132/1. The tock bit in the FPB 15s set to 
ensure "CLOSE WITH LOCK*™ if the NC 1s DS*ed. 


EXAMPLES: 


AUJITFILE AUDITOISK CDEVICE = DISKCARTRIDGE» 
LABEL = "PACKNAME™/*MYFAMILY"/"MYF ILE “> 
BUFFERS 2» VARIABLEs SAVE = 7> 
RECORDS 180/10» AREAS = 171000). 


oil 


AUDITFILE DEFAULT C ). 


AUDITFILE AUDITTAPE (DEVICE = TAPEs LABEL = "AUDITFILE*/™A"™> 
RECORDS = 1380/1). 


AUDITFILE PRNIR CDEVICE = PRINTER). 
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CONSTANT DECLARATION 


<CONSTANT DECLARATION>::= © CONSTANT <CONSTANT DEFINITION LIST>. 


<CONSTANT DEFINITION 
LIST>:s:=  <CONSTANT DEF INITION> 
= | | t <CONSTANT DEFINITION>» <CONSTANT 
DEFINITION LIST>. 


<CONSTANT DEFINITION>: := <CONSTANT IDENTIFIER>=<STRING> 
<CONSTANT IDENTIFIER>:2= <IDENTIFIER> 
SEMANTICS: 


Constant declaration provides a means of equating identifiers with 
strings. Subsequent references» occurrences of the identifier cause 
the compiler to substitute the equated string. This is useful for 
frequently used strings such as control characters» or common 
concatenations of control characters (ieee CONSTANT CRLF= 4 
”"0D250000" for * CARRIAGE RETURN“LINEFEED). Common control 
characters have been defined within the conpiler by default to the 


following Hexadecimal values: 


ACK = 2E E0T = 37 NUL = 00 
BEL = 2@F €SC = 27 POL = 97 
CAN = 18 TB = 26 RS = IE 
CR = OD ETX = O03 SI = OF 
OCl = 11 #FF = OC SEL = 98 
Dc2 = 12 +#-FS = 1C€ SO = OE 
Dc3 = 13 ##*FSL = A2 SOH = O1 
pc4& = 3C GS = 10 STX = 02 
JEL = OF HT = O05 SYN = 32 
DLE = 10 LF = 25 US = IF 
ENQ = 2D NAK = 30 VI = OB 
FS = 


These identifiers may be redefined to other strings» but may not be 
used as non=constant identifiers. —. 


BURROUGIS CORPORATION 
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EXAMPLES OF CONSTANTS: 


I. Vatid 


CONSTANT NUL = 
BADL = "ERROR™> 
RETRANSMIT = 

CONSTANT QUOTE = 


fe te re 


II. Invalid 


CONSTANT L2KANGAROD 
12. 
CONSTANT CLEAR 


&4"Q000". 


4°00" » 


i 


i 


NrRNR NE 


IDENTIFIER MUST BEGIN 
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"PLEASE SEND AGAIN". 


WITH LETTER. 
not a string. | 
RESERVED WORD MAY NOT 
BE USED AS CONSTANT 
MALFORMED STRING. 


meni a SS SS as eae 
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ONIF NAME DEC ATA 


<NIF NAME DECLARATION>::=.  NIF = <FILE NAME>. 


SEMANTICS: 


The name specified is substututed in the NIF FPB and in the object 
file's ?PB for the default name "NOL"/"NIF™. 3 


MAX TALL Y/TOG DECLARATION 


SYNTAX: 


MAX TALLY £ <INTEGER> } 
| MAX LINE © TALLY € <INTEGER> 1) . 
{ MAX TOG C <INTEGER> 1. | 
| MAX LINE € TOG € <INTEGER> 1). 


DECLARATION>::= . 


SEMANTIZS: 


on em apa 7 Tm ~— = oh 


The integer specifies the Largest allowable TALLY or TOGGLE and 
limits the TALLY or TOGGLE section of the line or station table. 


peo eens: 


1) No more than 100 TALLIES or TOGGLES may be 
declared» making the largest index 99. | 


2) If the declared maximum 1S exceeded by an 
| integer subscript» a warning will result and the 
maximum wittl be increased. : 


aoe | 
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REQUEST SECTION 


SYNTAX? 

CREQUEST SECTION>?::= <REQUEST LIST> 

<REQUEST LIST>::= | <REQUEST> <REQUEST LIST> 
i <REQUEST> 

<REQUEST>225— | REQUEST <IDENTIFIER>: 


-<REQUEST STATEMENT LIST> 


CREQUEST STATEMENT LIST>:i= <REQUEST STATEMENT> 
| i <REQUEST STATEMENT>. 
<REQUEST STATEMENT LIST> 


<REQUEST STATEMENT>: 2= <ASSIGNMENT STATEMENT > 
| 7 | <AUDIT STATEMENT> 

<CASE STATEMENT> 

<DISPLAY STATEMENT> 

<DO STATEMENT> 

<FETCH STATEMENT> 

<FINISH STATEMENT> 

<IF STATEMENT> | 

<INITIALIZE STATEMENT> 
_<INITIATE STATEMENT> 

<NULL STATEMENT> 

<RECEIVE STATEMENT> 

<TERMINATE STATEMENT> 

<TRANSMIT STATEMENT> 

<UNDO STATEMENT> 

<INCREMENT STATEMENT> 

<DECREMENT STATEMENT> 
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SEMANTICS: 


The REQJEST section is a series of line discipline routines 
CREQUESTs) which are used oy the Network  Controttler in 
communicating with the various remote devices. A REQUEST must be 
defined for each terminal. If it is possible for a terminal to send 
input to the system and receive output from the system then both a 
receive and transmit REQUEST must be defined for that terminal. The 
REQUEST to be used for each of these conditions is specified by the 
terminal's <REQUEST STATEMENT> as discussed tn the terminal section 
of this product specification. 


a Ea Se ee ee Pe eee eet EE 


REQUESTS are treated as I[/0 coroutines by the network CONTROLILer. 
For instances when a Line CONTROL desires to output a message to a 
TO5005 the NC selects the correct transmit REQUEST from the TC500 
terminal definition and gives it. CONTROL. The C500 transmit 
REQUEST executes the tine discipline until the 1/0 is successful or 
until it detects a serious errors at which point the NC regains 
controt. The REQUEST will also yield controt to the NC’ while 
hardware I/0 is in progress for the 10500 station. During this time 
the NC can process other Lines or yield to the MCP» until the I/0 
is complete. Thus the NC can handle several datacomm I/0 processes 
concurrently. Concurrency is transparent to the REQUEST» however. 
REQUESTs are coded as if I/0 were instantaneous. | 


Four R=QUEST statements are concerned with transfer of control 7 
"DO", “"UNDO"» "CASE*%» and “JF*. NOL has no “GO [0". There is no 
means of declaring subroutines for a REQUEST» nor may the 
programmer dectare tocal variables beyond those defined in_ the 
variables section. : | | | 


REQUESTs are Linked to specific terminals by referencing the REQUEST 
identifier in the <TERMINAL REQUEST STATEMENT> in the’ terminal 

section. REQUESTs are reentrants so two stations using the same 

REQUcCST may be handled concurrently on different lines. 


ao5 
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ASSIGNMENT STATEMENT | 


SYNTAX: 
<ASSIGNYENT STATEMENT>::=  <ASSIGNABLE VARIABLE> 
-<ASSIGNER> <EXPRESSION>. 
CASSIGNABLE VARIABLE>::= | (SEE VARIABLES) 
“SEMANTICS: 


= 2 om we ho oe mt oe oe 


“The <ASSIGNMENT STATEMENT> is the means by which an NDL REQUEST 
changes the value of an assignable variable. Examples: | 


TALLY COVS=TALLY (11 * 36 
TOG £117:=EXCEPTION OR LINE (TOG £01). 
TIME CTALLY)2=TIME. 
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AUDIT STATEMENT 


a me ot = + a om a 


SYNTAX: 


ee a ae 


<AUDIT. STATEMENT>3:3= AUDIT <AUDITFILE I[DENTIFIER> 
. - 3 | | C<AUDIT ELEMENT LIST>).. 
<AUDIT ZLEMENT LIST>::= <MESSAGE> 

os | <EXPRESSION LIST> | 
<EXPRESSION LIST>» <MESSAGE> 
<MESSAGE>» <EXPRESSION LIST> 
<EXPRESSION LIST>» <MESSAGE>>» 
<EXPRESSION LIST> | | 


<AUDITFILE IDENTIFIER>?:= (SEE <AUDITFILE DECLARATION 
OS | | ~STATEMENT> IN DECLARATION SECTION) 


: ) @MESSAGE>s f= ee BUFFER (<MESSAGE MODIFIER>) 
a | | aa 1 TEXT C<MESSAGE MODIFIER>) 
{1 WORKAREA (<MESSAGE MODIFIER>) 


Wo) <MESSAG MODIFIER>::= <I0> 
: : | - 1 <I0>» <INTEGER> 


oe a | INPUT 
| eae . 1 OUTPUT 


EXPRESSION LIST>::=  <EXPRESSION> | a | 
| | | <EXPRESSION>» <EXPRESSION LIST> 


2 ee. 
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SEMANTICS: 


The audit statement is a write to a user-declared file. The data to 
be written tis the <AUDIT ELEMENT LIST>» formed by concatenating the 
specified combination of <MESSAGE> and <EXPRESSION LIST>s. If the 
concatenated string is shorter than the auditfile record length» 
7. rightmost blanks will be addeds if longer» rightmost truncation 
: _ Will occur. See DECLARATION SECTION for the auditfile declaration 
| format. , | , | 


<MESSAG=> breaks down as follows: 
1. "TEXT" = message excluding the header 


2. "BUFFER™ - message including the entire 27-byte 
— header. 7 


56 "WORKAREA™ - terminal header workarea» tength as 
in. <HEADER SIZE STATEMENT> in terminal section. 


<INTEGE2> option in the message modifier tells the NC how many 
characters of the <MESSAGE> to audit. For examples this statement 
Writes the first 10 characters of the text to FILEA: 


AUDIT FILEA (TEXT CINPUT» 10)). 


The default value for <INTEGER> is O» indicating that the entire 
message Cup to the auditfile record size) is to be written. 


<EXPRESSION LIST> may be inctuded before or after or without 
<MESSAGI>. The fields resulting from evaluation of each expression 
are .- concatenated in the order specified. (See EXPRESSIONS for’ the 
length of expression values). The string functions» "DECIMAL" and 
"“CONVERT™» are useful here to change TALLIES» TOGGLES» and flags to 
 eastlytorintable format. [his example results in a 36"character 
string consisting of "TALLY 1 = nnn» INPUT = ttttttttte THATS ALL*: 


AUDIT FILEA C™TALLY 1 ="» DECIMAL (TALLY C1l]»>» 3)5 “» INPUT="> 
TEXT CINPUT,» 10)» “THATS ALL"). | | 
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CAS. STATEMENT 


SYNTAX: 

<CASE STATEMENT>22= — <CASE HEAD> <CASE BODY> 

<CASE HZAD>23= CASE “<EXPRESSION> 

<CASE 89DY>::= a cREQUEST STATEMENT. LIST> 
| CASE ENDING> 

<CASE ENDING>::= | a END CASE. 

SEMANTI>S: 


The <EX®RESSION> serves as an index into the list of <REQUEST 
STATEMENT>sS» the statement selected is executed» and the others 
ignored. Control is then transferred to the statement following the 
<CASE ENDING> unless the statement is an "UNDO". 


of <EXPRESSION> are from 0 through N-1. 
The statements in the list may be any —tegal <RE QUEST STATEMENT> 


allowed in NDOL- If the user wishes to execute nothing for a_ given 
value of <EXPRESSION>» the <NULL STATEMENT> is appropriate. 


A lS 1 rl i SSAA AL EDEL EE ee Bk i ee 


2 aed 


~BURROUGAS CORPORATION ig COMPANY CONFIDENTIAL 


COMPUTE? SYSTEMS GROUP 31700 NETWORK DEFINITION LANGUAGE 


SANTA BARBARA PLANT — Pe Se 2212 «5223 


ee aiba STATEMENT 


SYNTAX: 
<DECREMZNT STATEMENT>: = DECREMENT TRAN (<TRAN MODIFIER>). 
<TRAN MODIFIER>::= TRANSMIT. | 

| RECEIVE 


SEMANTI: 33 


The Decrement Statement decreases the value of an EBCDIC Decimal 
encoded transmission number by 1. It is intended to be used in 
systems where the MCS does not set output transmission numbers - 


TRAN MOOIFIER: 


TRAN CTRANSMIT) = OUTPUT TRANSMISSION NUMBER. 
TRAN CRECEIVE) - INPUT TRANSMISSION NUMBER. 


Example: The transmission number of the last output message was 
"380". DECREMENT TRAN CTRANSMIT) witl decrease the yalue to "379" 
CHexadecimal F3F7F9). The field wilt be set to att "9"s = on 
underflow. 
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DIS?>LAY STATEMENT 


SYNTAX: | 
<DISPLAY STATEMENT>: == DISPLAY <EXPRESSION LIST>. 
EXPRESSION LIST>23= - <EXPRESSION> | 

_ | <EXPRESSION>» <EXPRESSION LIST> 
SEMANTICS: 


Display puts a character string out to the SPO via a communicate. 


IF 9: 
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DD STATEMENT 


SYNTAX: 
<00 STATEMENT>::= <DO HEAD> <REQUEST STATEMENT 
| LIST> <END PART> 
<00 HEAD>::= | DO <IDENTIFIER PART> 
| <FOREVER PART>. 
<END PART>32=_ 7 END <INDENTIFIER PART>. 
<LDENTIZIER PART>:= <D0 IDENTIFIER> 
- | 1 <EMPTY> 
 <FOREVE? PART>22=— FOREVER 
| 7 | <EMPTY> 
<DO0 [DENTIFIER>?:= | <IDENTIFIER> 
SEMANTICS: 


The 00 Statement provides a means at grouping two or more REQUEST 

statements Cinctuding other. <DO STATEMENT>s) as one statement. This 
is useful in <IF STATEMENT>s and <CASE STATEMENT>s- DO Statements 
may be nested. The DO-Identifier is optional. Examples: 


IF TOGC1} THEN 
DO OUTER. 
DO INNER FOREVER. 
FETCH CHARACTER. 
IF CHAR EQ ETX THEN UNDO INNER. 
END INNER. - | 
TALLY €12 := TALLY (11 + 1. 
END OUTER. 


FOREVER forces the CREQUEST STATEMENT LIST> to be repeated until an 
UNDO or a TERMINATE is encountered. | 
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1. If a <DO IDENTIFIER> is included in the <00 
HEAD>» it must also appear. in the <END PART>- 


2e If the <D0 HEAD> does not include an identifier. 
The <END PART> must not contain one. | 


sit 


BURROUGIS CORPORATION : COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | Bi700 NETWORK DEFINITION LANGUAGE 


SANTA BARBARA PLANT | | PeSe 2212 5223 


FETSH STATEMENT 


<FETCH STATEMENT>::= _ FETCH <POINTER ADVANCE PART> 
_ -s | <FETCH OBJECT>. 
<POINTE? ADVANCE PART>::=  O4NLI<EMPTY> 
<FETCH JBJECT>:3= | CHAR 
| | CHARACTER 
4) <EMPTY> 
SEMANTICS: 


FETCH is only used in processing input. Before using FETCH» an 
"INITIATE RECEIVE™ should be executed. Att <FETCH OBJECT>s have the 
same meaning = FETCH always loads the character register with the 
character inthe input message addressed by the message pointer- 
The .message pointer is advanced by 1 character after the FETCH if 
the <POINTER ADVANCE PART> is 1 or <EMPTY>. A zero <POINTER ADVANCE 
PART> leaves the message pointer unchanged» so a subsequent FETCH 
or receive accesses the same character. NoBo? "ENDOFBUFFER™ will be 
set if the FETCH is executed with the message pointer set beyond 
the last character in the buffer. 
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FINISH STATEMENT 


SYNTAX: 


<FINISH STATEMENT>:3= 


“<TRANSMET PART>::= 


<TRANSMET LIST>: 5 


<TRANSMIT ATTRIBUTE>?: 


- <TRANSMIT BASIC 


ATTRIBUTE>::= 


<TRANSMIT-RECEIVE 
PART>::= | 


" <RECELVE PART>::= 


SEMANTI: S3 


"FINISH TRANSMIT" causes 
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FINISH TRANSMIT <TRANSMIT 
PART>“~<TRANSMIT-RECEIVE PART>.« 


C<TRANSMIT LIST>] 


<TRANSMIT ATTRIBUTE> 
<TRANSMIT ATTRIBUTE >» <TRANSMIT LIST> 


<TRANSMIT BASIC ATTRIBUTE> 
NO <TRANSMIT BASIC ATTRIBUTE> 


EOT # CR I TRANSLATE 


ee RECEIVE <RECEIVE PART> 


CSEE INITIATE Pees 


transmission of the output message 


constructed by a series of <TRANSMIT STATEMENT>s. "FINISH TRANSMIT 
 YFNITIATE RECEIVE" Links to the transmit. I/0 descriptor a receive 


1/0 descriptor which 
complet2s without error. 


hardware executes if the transmit | 


CA WriterFlip To ~mRead Operation). 


The <TRANSMIT BASIC ATTRIBUTE>s set variants in the hardware 1/0 


descriptors they are 


instructions to the B1700 Datacomm Hardware. 


EOT : EJT Is to be treated as a control character. 


CR: CR is to be treated as a control character Cre etree Benet onty). 


TRANSLATE = Translate EBCDIC to ASCII. 


DEFAULTS = Translate, 


no CR 


dae nF ee a ah al Sie a ee EE at RE Sl a Re ne er re Ae cate cet Rl el i kl tN ED nit Sk ah re Sr as i ne a tl Si EE ee ee Se ba CR 
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‘IF STATEMENT 


SYNTAX? 
CIF STATEMENT>::= ——-—~”—CSX'. SEXPRESSTON> THEN <REQUEST STATEMENT> 
| | c<ELSE PART>. 
CELSE PART>22= | ELSE <REQUEST STATEMENT> 
1 <EMPTY> 
SEMANTICS: 


The <EX?RESSION> is evaluateds and the statement following the 


"THEN® ais executed if the teast significant bit of the value is 
equal to one (true). If the bit is off (false) the "ELSE" statement 
Cif prasent) is executed. In all cases» control passes to the 
statement following the IF statement. Any <REQUEST STATEMENT> is 
legal after “THEN™ and “ELSE™ including <IF STATEMENT>s» <NULL 
STATEMENT>s» and <DO STATEMENT>s~. Exampte: 


IF CHAR NE ACK 
THEN DO. RECEIVE ADDRESS (RECEIVE). 
- IF ADDERR a 
THEN TERMINATE ERROR. &% No "ELSE™ 
END. | 
ELSE INITIATE RECEIVE. 
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INCREMENT STATEMENT 


SYNTAX: 
-  €ENCREMENT STATEMENT>::= INCREMENT TRAN C<TRAN MODIFIER>) 
<TRAN MIDIFIER>2:= = = TRANSMIT 
| : | RECEIVE 
SEMANTICS: -_ 


The increment statement provides a means of changing the value of an 
EBCDIC encoded transmission number by 1. It is intended to be used 
With output transmission numbers tn systems where the MCS does not 
maintain the numbers. — | 


TRAN MODIFIER: 
TRAN CTRANSMIT) = OUTPUT TRANSMISSION NUMBER 
TRAN CRECELVE) - INPUT TRANSMISSION NUMBER 
Example: The output transmission number of the last meseaue Was 
"379". |§™INCREMENT TRAN CTRANSMIT).™ will bump the value to "380" 


Cin Hexadecimal notation: F3F8F0). The field witt be set to 
character zeroes on overflow. 7 
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INITIALIZE STATEMENT 


SYNTAX: 
<INITIALIZE STATEMENT> =: = INITIALIZE <ITEM LIST> 
<ITEM LIST>32= _ <I TEM>> 
: » | <ITEM>» <ITEM LIST> 
CITEM>22= | | TEXT a 
_ 1 TRAN CRECEIVE) 
1 TRAN CTRANSMIT) | 
1 TALLY C<TALLY INDEX] 
1 TOG €<TOG INDEX>] © 
1 RETRY | 
SEMANTICS: 


"INITIA_-IZE TEXT™ sets the input message pointer in the NC to the. 
first dyte of the input buffer Cincluding the terminal header). It © 
is done automatically by “INITIATE RECEIVE” and by a success ful 
completion of autopoll. © | : 


"INITIALIZE TRAN CRECEIVE)™ resets the station input transmission 


number to binary zeroes. 


"INITIA WIZE TRAN C(TRANSMIT)”™ sets the station output transmission 


number from the output external message header if a message 1s 


attached» otherwise to character zeroes. 


“INITIALIZE <TALLY/TOGGLE>" sets the listed TALLYS and TOGGLES from 


the internal 27-byte message header if there is ones else to zero. 


| "INITIA_IZE RETRY™ resets retry to its starting value (See <RETRY 


STATEMENT> in STATION section). 
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m COMPUTER SYSTEMS GROUP 


SANTA BARBARA PLANT 


INITIATE STATEMENT 


_<INETIATE STATEMENT: 2= 


<INITIATE ACTION>::= 
<RECEIVE PART>:2= 


<RECEIVE LIST>::= 


<RECEIV= ATTRIBUTE>:2= 


<RECELVZ BASIC 


ATTRIBUTE>2:= | 
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INITIATE <INITIATE ACTION> 


RECEIVE <RECEIVE PART> 
TRANSMIT 


<EMPTY> 
C(<RECEIVE LIST>) 


<RECEIVE ATTRIBUTE> | 
CRECEIVE ATTRIBUTE>» <RECEIVE LIST> 


<RECEIVE BASIC ATTRIBUTE> 
NO <RECEIVE BASIC ATTRIBUTE> 


~ CONTROL 


TRANSLATE 
TIMEOUT 
EOT | 
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SEMANTI7S: 


The INITIATE RECEIVE form o f he <INITIATE STATEMENT > commands the 
adapter (i.e. «LINE) to accept input. | 3 


INITIAT= TRANSMIT sets the output message pointer to the first Dre 
In the dutput message buffer» 


CONTROL implies that the data wittl be input into the tine Input. 
CONTROL workarea as opposed to the input buffer. 


TRANSLATE attribute causes hardware translation of data received. 
TIMEOUT attribute enables the receive timeout timer. 
EOT causes oe adapter to creat EOT as a CONTROL character. 


CR Ctelatype Sdagtor only) causes the adapter to ceeat CR as a 
CONTROL character. 


PARITY (teletype adapter only) causes’ parity checking of each 
Character. Parity checking on other adapters will not be affected 
by this option. | 


DEFAULTS: TIMEQUT» TRANSLATE» EQT» NO CR» NO CONTROL» NO PARITY. 
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NUL. STATEMENT 


<NULL STATEMENT>: 2= <EMPTY>. 


SEMANTICS: 


The NUL. statement may be used in an IF or CASE where an executable 
statement is required but a NO“UGP is desired. Example: | i 


CASE TALLY( 3]. 
IF TOG (31 THEN. % NULL 
ELSE INITIATE INPUT. 
« Z NULL 
<REQUEST STATEMENT LIST> 
END. | 
EN) CASE. 


Note that the case contains three executable at Abeunness an IF. a 
NULL» and a DO. If TALLY €0] is equal to 1 entering the case,» the 
NULL path is taken and the case is exited immediately. If TALLY [0] 
is equal to 0» the if path is taken. If the THEN branch is taken» 
this NULL also results in exit from the case. 
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RECZIVE STATEMENT 


SYNTAX: 
<RECEIV: STATEMENT>?2= RECEIVE <ITEM LIST>. 
<ITEM LIST>25= © 7 : <ITEM> ie 
| | 1 <ITEM>» <ITEM LIST> 
<ITEM>tt= ca ADDRESS <ADDRESS QUAL IFIER> 
a = 1 TEXT 
i <STRING> 
1 <CONSTANT>: 
1 TRAN <TRAN QUALIFIER> 
<ADDRESS QUALIFIER>::=. (RECEIVE) 
_ 4 7 1 (TRANSMIT) 
1 (STATION) 
<TRAN QJALIFIER>?3= | (RECEIVE) 
| | | 4) CTRANSMIT) 
| <EMPTY> : 
SEMANTICS: 


The receive statement is used. in input REQUESTs following an 


"INITIATE RECEIVE*. Starting with the current setting of the input 
message pointers each item in the <ITEM LIST> is tested against the 
correspznding field in the input message. I[f they do not agrees the 
appropriate <ERROR FLAG> is set. Items are as follows: 


ADDRESS CRECEIVE)/ ADDRESS (TRANSMIT) refer to the strings specified 


gn the station's <STATION ADDRESS STATEMENT> (See STATION Section). 


If the address in the input message does not agree with the 
specified address» “ADDERR™ is set. | | 
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ADDRESS CSTATION) 


The address field in the message witl be compared against’ the 
receive addresses of alt stations on the current line. If no match 
is founds ADDERR is set. If a match its founds the station index its 
reset to the matching station (neb. This has serious implicattons 
for RZQUEST coding = all the variables that are station-specific 
are now different. For instances TALLY (C0-2) and TOG [0-7] 
reference entirely different fields after a .successful RECEIVE 


ADDRESS CSTATION))~. ADDRESS CSTATION) provides the REQUEST. writer 
with a means of implementing group poll» contentions and RJE Line 


disciplines» since this 1s the only NDL language construct’ that 
permits a REQUEST to change station index at run time and respond 
to any of a set of stations which may have originated the current 
message. 


TEXT 


The input message pointer is set to the last character in_ the 


messager» on the assumption that a terminating character follows. If 


more characters were received than specified in the station's 
<MAXINP JT STATEMENT>» ENDOFBUFFER is set~ Note: A run error will 
result af RECEIVE TEXT is executed after INITIATE RECEIVE 


(CONTROL). 


STRING? CONSTANT 


FORMATERR is set if the corresponding characters don't agree. 
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TRAN 


TRAN CRICEIVE) / TRAN CTRANSMIT) refer to the transmission numbers 
of the last input/output message» respectively. If the characters 
in the tnput message are equal to the referenced last transmission 
numbers TRANERR 1s) set. Tran <EMPTY> is equivalent to 
TRANCRECEIVE). 


Example: If a certain terminal uses this input format- SOH» ADDRESS>» 
TRANSMISSTON NUMBER» STX» TEXT» ETX - then it may be checked with 
this receive series: | | | 


RECEIVE SOH» ADDRESS» STX» TEXT» EX. 
IF FORMATERR THEN UNDO. | | 
RECEIVE ADDRESS CRECEIVE)» TRAN CRECEIVE). 
IF ADDERR GR TRANERR THEN UNDO. 
RECEIVE STX» TEXT» ETX. 
IF FORMATERR OR ENDOFSUFFER THEN UNDO. 
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TERYINATE STATEMENT 


<TERMINATE STATEMENT>2:= TERMINATE <TERMINATE OPTION>. 


<TERMINATE OPTION>::= | DISCONNECT 

| | 7 ECHO 
ERROR 
INPUT 
INPUT CRETURN) . 
INPUT CRETURN» NO BUFFER) 
LOGICALICK 
NOINPUT 
OUTPUT 
RELEASE STATION 
OUTPUT CRETURN) 


ee ee ee ee ee ee eee 


SEMANTICS: - 


TERMINATE is used to exit a REQUEST. Depending on the option 
selected» the TERMINATE may cause buffer atilocation/dealtlocations 
message queueing/dequeueingsr changes in station status» and saving 
of the current REQUEST. If state is saved (See "RETURN® options) 
then the REQUEST can be restarted at the statement following the 
terminate. If state is not saved (Catt other options) then the 
terminate ends the REQUEST. | 


ALt REQJESTs must end with a nonwstate"saving terminate. [If none is 
supplied» no syntax error will result. Howevers should controt fall 
past the last statement in the REQUEST» the compiler automatically 
generat2s a TERMINATE ERROR at the end. 
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TERMINATE pelt dataas 


DISCONNECT 


Used in REQUESTs when the last 1/0 had an error indicating loss of 

connection such as loss of data set ready. A break I[/0 with the 
disconnect variant is issued. If stations are stilt enabled on the 
tine» a new test/wait for ring is sents 


Used in receive REQUESTs to signal completion of an input Line 

discipline. The result index is set to show successful input. The 

27-byte message header is appended to the input text» and the input 
: message is queued for the MCS/user program. Any output message 

: still attached is assumed to have been successfully transmitted» so 

i the output buffer is dewatlocated. The line may now be used “for 

other 1/0. The REQUEST ends. | | 


INPUT CRETURN) 


Used to signal successful reception of a block (not the last) of 
input. As in "TERMINATE INPUT" the message 1s completed and queued. 
Another input buffer is allocated. No action 1s taken on attached 
output nessages. Control is returned to the next REQUEST statement. 


INPUT CRETURN» NO BUFFER) 


Signals successful reception of an input messages but not completion 
of che Line discipline. Input message is completed and queued. No | 
new buffer is allocated. No action is taken on attached output 
messagese Flow of control returns immediately to the next statement 
In sequence. This option is tintended to be used to  overtap 
processing of an input message by the MCS/user program with 

acknowledgement of reception by the REQUEST. | 
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ADDRESS (STATION) 


The address field in the message will be compared against the 
receive addresses of alt stations on the. current Line. If no match 
is founds ADDERR is sete If a match is founds the station index 15 
reset to the matching station (nb. This has serious implications 
for R= QUEST coding - all the variables that are station-specific 
are now different. For instance» TALLY €0°72] and TOG [0-7] 
reference entirely different fields after a .successful RECEIVE 


ADDRESS CSTATION)). ADDRESS CSTATION) provides the REQUEST writer 
with a means of implementing group poll» contentions and RJE Line 


disciplines» since this is the only NDL language construct that 
permits a REQUEST to change station index at run time and respond 


to any of a set of stations which may have originated the current 


message. 


TEXT 

The re message dane: is set to the last character in the 
message» on the assumption that a terminating character follows. If 
more characters were received than specified in the station's 


<MAXINP JT STATEMENT>» ENDOFBUFFER 15 set. Note: A run error will 
result of RECEIVE TEXT is executed after INITIATE RECEIVE 


CCONTRO_). 


STRING» CONSTANT 


FORMATER2R is set if the corresponding characters don't agree. 
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~LOGICALACK 


The input REQUEST is interrupted but not ended and the input message 
queued. If LOGICALACK 1s true for this station and an MCS present» 
the inout message will be queued for the MCS otherwise the input 
message 1s queued for the user program and the REQUEST continues. 


LOGICALACK is a method of verifying recetpt of messages through an 
MCS. The Network Controller will not restart if an error is 
detected as indicated by the message result: 


1. INVALID LSN IN RESPONSE 
2. LINE NOT WAITING FOR RESPONSE 
(3. INCORRECT LSN IN RESPONSE 


Successful completion of an output line discipline. A completion 
= message is queued for the MCS if required. Output buffer and = any 
Ly attached input buffer are dev~allocated. The REQUEST ends. 


OUTPUT CRETURN) 


Signals successful transmission of a btock of outputs but not 
completion of the Line discipline. The old output buffer is 
de-allocated» but no action is taken on any attached input buffer. 
The state of the REQUEST is saved» and the line CONTROL is entered 
C LINE CCONTROL KEY)=4 ). The CONTROL must restart the REQUEST with 
a "CONTINUE". When the REQUEST is restarted» it begins to execute 
the statement following “TERMINATE QUTPUT CRETURN)™. The REQUEST 
should test the value of "OUTPUTATTACHED™ to determine if another 
output nessage has been attached before trying to transmit. 
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ECHO 


This option is supplied = for writing REQUESTs~ for the initial 
shakedown of an NDL datacomm system. Instead of putting an input 
message in the MCS queues "TERMINATE ECHO™ puts the message in the 
station's output queues so the station's output REQUEST can echo it 
back. The input REQUEST ts ended. | | 


ERROR 


Used to inform the NC of an unsuccessful attempt to transmit or 
receive. An error message 15 queued for the MCS or user programe If. 
an MCS is present the station is marked down. Attached input 
buffers are released» while attached output messages are re=queued-. 


NOINPUT 


Signals an unsuccessful attempt to receive inputs but without errors 
(receiving an E0T» for example, ending a conversational line 
discipline)» The input buffer is deratlocated» and any output 
message is re-queued for an output REQUEST. State is tost.e 
"TERMINATE NOINPUT™ may be used In a transmit REQUEST just to 
re"queu2 the output message» perhaps to broadcast a message to more 
than one station. | 


RELEASE STATION. 


Releases a station not physicatly present on one Lines, making it 
available to other lines in the Line groupe TERMINATE RELEASE 
STATION clears the station table entry STATIONCLINE) to zero. 


ae StS te ee acct 
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TERMINATE OPTIONS 
INPUT OUTPUT 
MESSAGE MESSAGE STATE OF | 
OPTION - . REQUEST TYPE REQUEST 
DISCONN=ICT: LOST Lost LOST ALL 
ECHO QUEUED FOR NO ACTION LOST DEBUGGING 
| TRANSMIT | 
ERROR LOST RE-QUEUED LOST RECEIVE>s TRANSMIT> 
— CONVERSATIONAL 
| INPUT QUEUED ‘LOST LOST RECEIVE OR 
| : CONVERSATIONAL 
INPUTCRZ TURN). QUEUED NO ACTION SAVED CONVERSATIONAL OR 
| | CIMMEDIATE BLOCK RECEIVE 
_ RETURN) 
LOGICALACK QUEUED LOST SAVED RECEIVE 
i OUTPUT LOST LOST LOST TRANSMIT OR 
: CONVERSATIONAL 
| QUTPUTCRETURN) NO ACTION LOST SAVED — CONVERSATIONAL OR 
J | CCONTROL BLOCK TRANSMIT 
| MUST | 
7 CONTINUE) 
| RELEASE STATION LOST. QUEUED Lost RECEIVE, TRANSMIT 
INPUTCRETURN>  QUEUED NO ACTION SAVED RECEIVE 
: NO BUFFER). | | CIMMEDIATE 
, | RETURN) 
| NOINPUT LOST RE~QUEUED LOST RECEIVE» TRANSMIT 
: IF NECESS. 
, 
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: TRANSMIT STATEMENT 
SYNTAX! 
CTRANSMIT STATEMENT> #2 TRANSMIT <ITEM LIST>- 
<LTEM LIST>22= TT EMD | 
| | <ITEM>+ <ITEM LIST> 
<I TEM> 222 | | ADDRESS <ADDRESS QUAL IF IER> 
| 1 TEXT 
1 <STRING> 
1 <CONSTANT IDENTIFIER> 
1 TRAN <TRAN QUALIFIER> 
1 CHAR 
1) CHARACTER 
<ADDRESS QUALIFIER>?2=_ ~ CRECEIVE) 
| , «4 (TRANSMIT) 
M CTRAN QJALIFIER>22= (MESSAGE) 
| | 1 CRECEIVE) 
| ob CTRANSMIT) 
| 1 <EMPTY> 
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SEMANTICS: 


The <TRANSMIT STATEMENT> is used for output to a station. <ITEMS> 
are concatenated until the <ITEM LIST> is exhausted. <ITEMS> from 
subsequent <TRANSMIT STATEMENT>s are added to the concatenation 
until a “FINISH TRANSMIT" statement is executed» at which time the 
entire string is actually sent to the station. 


TRAN CRICEIVED/ 


TRAN CTRANSMIT) =) Transmission number in the station table. 


TRAN <EMPTY> - Equivalent to TRANCTRANSMIT) 
TRAN<EMPTY> - Transmission number from 27-byte message 


header 


ADDRESSCRECEIVE)/ 


ADDRESSC TRANSMIT) = Address from station table. 


CHAR/CHARACTER - Character register. 


<CONSTANT IDENTIFER> - 


/<STRING> - loads the specified characters. 


Eas nde Seek oe 
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UND STATEMENT 


SYNTAX: 
<UNDO STATEMENT>:i= UNDO <DO0 OPTION>. 
<00 OPTION>::= | <EMPTY> 

4 1 <DD [DENT IF LER> 
“SEMANTICS: 


The UND) statement is used to exit. a 00- GROUP. Upon execution of an 
UNDO» control transfers to the statement following the dovgroup's 


wEND"™. 
DO eerie 


wuVp0." Transfers. conueal out of the innermost DO- GROUP in 
which the statement appears. | 


"UNDO <IDENTIFIER>.™ Transfers control out of the DO-GROUP 
with the same identifier. 


EXAMPLE: 


00 OUTER. 
| D0. : | | 
IF TOGLO] THEN UNDO. Z EXITS UN-NAMED 00 
DO INNER. | 

IF TOG£L1I] THEN UNDO. % EXITS "INNER" 

UNDO OUTER. % EXITS “OUTER™ 

END INNER 
END. 

EN) OUTER. 


6-1 


BURRDUGIS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP --- B1700 NETWORK DEFINITION LANGUAGE 
SANTA BARBARA PLANT P.S. 2212 5223 


CONTROL SECTION 


SYNTAX: 


<CONTROL STATEMENT LIST> 


<CONTROL SECTION>::= <CONTROL LIST> 
<CONTRO_ LIST>:2= | <CONTROL> 
| | | | <CONTROL> <CONTROL LIST> 
| <CONTROL>22= CONTROL <CONTROL IDENTIFIER>: 


<CONTROL STATEMENT | | 
LIST>2:5 | <CONTROL STATEMENT> 
| | 1 <CONTROL STATEMENT> | 
| — <CONTROL STATEMENT LIST> 


-<CONTROW IDENTIFIER>?:= <IDENTIFIER> 


<CONTRO. STATEMENT>::= © <ASSIGNMENT STATEMENT>- 
| | <CASE STATEMENT> 
<CONTINUE STATEMENT> 
<DISPLAY STATEMENT> 
<DO STATEMENT> 
<IF STATEMENT> 
<CONTROL INITATE STATEMENT> 
<NULL STATEMENT> 
<POLL STATEMENT> 
<UNDD STATEMENT> 


— mh wae Se ess lel lee Oe 


SEMANTICS: | 


Each tine in an NOL system must have a CONTROL associated with it by 
means of the <LINE CONTROL STATEMENT> in the Line section. The 

userewritten CONTROL ts invoked by the NC when it is necessary to 

decide which of a set of contending I/0 functions gets the use of 

the Lina. The duties of a CONTROL are 


le Creation of poll List» if anye 
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Zs Choosing a station on the Line by testing system 


variables (LINE CCONTROL KEY)» STATION CQUEUED)> 
FREQUENCY» SST AT LON + etc.) or by polling. 


3 Inittation or kee cat eene of the REQUEST for the 
7 chosen station. | 


REQUESTs are treated as I/0 subroutines by CONTROLs.~ It is the 
CONTROL that decides when and for which station a given REQUEST is 
to be executed. The REQUEST is invoked by the <CONTROL INITIATE 
STATEMENT>. i | 


Unlike REQUESTs» CONTROLS may never save state and. suspend | 
themselves. CONTROLS are always entered at the first instruction 
and run until they execute an <INITIATE STATEMENT> or a  <CONTINUE 
STATEMENT>» whereupon the CONFROL is terminated in favor of the NC 
or the appropriate REQUEST. 


The first thing a CONTROL should do is determine the state of the 
line by checking the value of LINECCONTROL KEY). CSee SYSTEM STATUS 
VARIABL=IS for the meaning of the different values). Certain values 
of this item timit the range of action of the CONTROL or force the 
CONTROL to take one course of action. 


Six CONTROL statements CASSIGNMENTs» CASE» OO» IF» NULL» UNDO) are 
virtually. identical to the corresponding REQUEST statements. The 
<CONTROL INITIATE STATEMENT> however serves an entirely different 
purpose from the <INITIATE STATEMENT> in the REQUEST section. 


BURROUGIS CORPORATION 
COMPUTE? SYSTEMS GROUP 
SANTA BARBARA PLANT 


ASSIGNMENT. STATEMENT 


<ASSIGNYENT STATEMENT>:2= 


<CONTRO_ ASSIGNABLE 
VARIABLi>ss= 


SEMANTI< St 
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<CONTROL ASSIGNABLE VARIABLE> 


<ASSIGNER> <EXPRESSION>. 


(SEE VARIABLES) 


Used t 2 change the value of a system variable. The variable to be. 
assigned» as well as any Variables appearing in the expression» 
must be referenceable in CONTROLs.~ Example: _ 


STATION:= 
CAS. STATEMENT 


<CASE STATEMENT>: 2= 


<CONTRO. STATEMENT 
LISTo>ss= 


| SEMANTIS 3: 


STATION + 1. 


CASE <EXPRESSION>. 
<CONTROL STATEMENT LIST> 
END CASE. 


<CONTROL STATEMENT> 


<CONTROL STATEMENT> 
<CONTROL STATEMENT LIST> 


‘bodes ies REQUEST: section. 
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CONT INUE STATEMENT 


SYNTAX: 
<CONTINJE STATEMENT>=22= CONTINUE. 
SEMANTI2S: 


The <COVTINUE STATEMENT> is used in conjunction with the "TERMINATE 
OUTPUT CRETURN)™ statement in the REQUEST section. It returns 
control to -the instruction following the previous "TERMINATE 


OUTPUTCZETURN)™ statement in the REQUEST section. 


DISPLAY STATEMENT 


Same as display statement in REQUEST section. 
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~—20 STATEMENT 


— <DO STATEMENT>22= <D0 HEAD> 3 
| <CONTROL STATEMENT LIST> 
<END PART> 


D0 HEAJ>=:= | DO<DQ IDENTIFIER PART> 
7 <FOREVER PART>. 


<END PART>I:= ENO <DO IDENTIFIER PART>. 


<DO IDENTIFIER PART>22=. -EMPTY> 
1 <IDENTIFIER> 


<FOREVE? PART>::= © <EMPTY> 
| 1 FOREVER 


SEMANTICS:. 


Same as REQUEST section <0G STATEMENT>. 


BURROUGIS CORPORATION 
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IF STATEMENT 


<IF STATEMENT>:2= 


<ELSE PART>22= 


SEMANTICS:. 


COMPANY CONFIDENTIAL 
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IF<EXPRESSION> THEN <CONTROL 


<ELSE PART> 


ELSE <CONTROL STATEMENT> 
<EMPTY> Ys 


Same as REQUEST section <IF STATEMENT>. 


STATEMENT> 


NOTE: Variables in the <EXPRESSION> must be CONTROL-referenceable. 


r 
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CONTROL INITIATE STATEMENT 


<CONTROW INITIATE | 
STATEMENT> 22 = 7 INITIATE <INITIATE OPTION> 


<INITIATE OPTION>::= | <I-0 OPTION> 

oe | <AUTOPOLL OPTION> | 
<IDLE OPTION> ~~ 
<CANCEL OPTION> 
<DISCONNECT OPTION> 


<1-0 OPTION>::= INPUT 

— | OUTPUT 
INPUTOUTPUT 
OUTPUTINPUT 
INPUTCNO BUFFER) © 
OUTPUTCNO BUFFER) 


<AUTOPO_L OPTION>:2= — AUTOPOLL<AUTOPOLL SLAVE ADDRESS> 


<AUTOPOLL SLAVE ADDRESS>::= (<INTEGER>) 


| t <EMPTY> 
<IDLE O° TION>:3= IDLE 
<CANCEL OPTLION>?::= CANCEL 


<DISCONVECT OPTION>::= DISCONNECT 
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SEMANTICS: 


INITIAT= ts a statement that (1) ends the CONTROL» and (2) depending 
on the options either starts an I[/0 REQUEST» cancels an I/0 in 

progress» starts hardware autopotl» or idles the Line. The initiate 

aption executed must be appropriate to the current Line and current 

station status. For instance "INITIATE OUTPUT" if there is no 

message queued for the current station wilt cause a_e fatal 

run-error. It is the NOL programmer's responsibilty to either test 

alt relevant conditions before executing an initiate» or to 

structure his NOL program so that the INITIATE cannot be 

inappropriate. See following for requirements of each option. 
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/ 


1-0 OPTLON: 


ALL [-0 option variants begin a REQUEST. Which REQUEST is chosen 
depends on the variant and the stationts <TERMINAL REQUEST 
STATEMENT> as defined in the terminal section. | 


INITLIATZ INPUT starts the input REQUEST» attaches an input buffer 
and sets INPUTATTACHED to true. The station must be valid» readyer 
enabled» © and STATION (MYUSE) must altow input (See  <MYUSE 
STATEMENT> in the station section). Example: 


IF STATIONCVALID) AND STATIONCREADY) AND 
STATION CENABLED) AND CSTATIONCMYUSE) NE 2) 
THEN INITIATE INPUT. 


INITIAT= ENPUTCNO BUFFER) also starts the input REQUEST» but no 
input buffer is attached. To get an input buffer Later» the REQUEST 
must execute a TERMINATE INPUTCRETURN). Same requirements as 
"INITIATE INPUT®. . 


INITIATE OUTPUT starts the output REQUEST» attaches an output 
messages and sets GUTPUTATTACHED to true. The current station must 
be valid» ready» queued» and STATIONCMYUSE) must permit output. 


INITIAT= OUTPUTCONO BUFFER) tis just like INITIATE OQUTPUT>» but = no 
message 1s attached» even though one must be queued for output in 
order to execute this initiate. To get the message while runninge 
the REQJEST must execute a TERMINATE OUTPUTCRETURN). | 


INITIAT= INPUTOUTPUT starts the input REQUEST» while INITIATE 
OUTPUTINPUT starts the output REQUEST. Otherwise they have the same 
effect - both get an input buffer and an output message» and both 
set INPUTATTACHED and OQUTPUTATTACHED true. The station must be 
enabled» valid» ready and queued» and STATIONCMYUSE) must equal 3 
(I/0).- These initiates are used to start conversational tlLine 
discinptines. | | 
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| AUTOPOLL OPTION: 


This initiate takes the poll string built by means of the <POLL 
STATEMENT> and fires an 1/9 starting recirculating polling 
_ CTAUTOPILL™). Polling continues automatically until a message _ is 
|  peceived or an error occurse Then "STATION" is set to the proper 
| value and the input REQUEST tis entereds as if an "INITIATE INPUT" 
7 : had been excuted. The REQUEST should check for I/O exception. 
-  Rerinitiating autopoll causes polling to pick up where it Left off. 
The polt string need only be renmbuilt to add or delete a_ station. 


<AUTOPO_L SLAVE ADORESS> is required onty when the station may reply 
with address different from the polled address» as in controller = 
stave station configurations. The tnteger specifies the position of 
the first character of the slave station address in the message 
received. Note--the characters in the message are numbered from l» 
$0 if the address began tin the third character of the message» the 
integer should equal "3". 3 | : 


IDLE OPTION: 


The Lin2 is put in a state of semi-permanent rest. It is marked not 
busy byt left ready. While idles the line CONTROL will not be 
entered» so the Line wilt not respond to stattons attempting input» 
and any messages that were queued for output on the line at the 
time it was idled will not be transmitted. This command might be 
used to ease the load on the system by deactivating a line on which 
no traffic is expected. Inittate idle terminates the CONTROL Cit is 
reentered from the top). The line can be reactivated by 3 events: 


1. An MCS "CHANGE" command to the NC. 


25. A file open by a user program involving a 
station on this lines if no MCS 1s present 


[- An output message is queued for ai station = on 
this Line» and this station has no other 
messages queued. | 
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CANCEL OPTION: 


Halts the read I/O that is presently in progress on this line. Since 
a line can only perform one task at a times the line CONTROL 1s not 
normally entered while an I[/0 is tn progresse An exception occurs 
when | | 


Ls The line is performing a read that can go on 


indefinitely Cautopoll» read with no timeout), 
and 

Ce The Line has no output messages queued» and 

LP A message 1S now queued “for output» In 


contention with the ongoing read. 


The CONTROL is entered with LINE CCONTROL KEY) equal to 2» giving it 


an opportunity to stop the read with an “INITIATE CANCEL™. After 


cancelling the read» the NC wilt reo ent er the CONTROL with LINE 
(CONTRO. KEY) equal to 0. ; | 


DISCONN=CT OPTION: 


Shuts down a lines» releases associated stationss and hangs up. Used 
when all stations no longer require service (not enabled» timing 


out» not performing output» etc.). 


NUL STATEMENT 


same as null statement in the REQUEST section. 
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POLL STATEMENT 


SYNT AK: 
<POLL STATEMENT>::= = POLL<POLL ELEMENT LIST>. 
«POLL ELEMENT LIST>::= <POLL ELEMENT> 
| 3 | <POLL ELEMENT>» <POLL ELEMENT LIST> 
<POLL ELEMENT>::= : — <CONSTANT [DENTIFIER> 
| 1 <STRING>. 
| <ADDRESS> 
<ADDRESS>22= ADDRESS 
| | | 1 ADDRESSCTRANSMIT) 
SEMANTICS: 


ised to create a poll string prior to initiating autopoll (See 
AUTOPOL. option of <CONTROL INITIATE STATEMENT>). The line CONTROL 
should cycle through the stations on the lines executing POLL once 
for each station to go in the poll stringe A <POLL ELEMENT LIST> 
must contain exactly one occurrence of <ADDRESS>. ADDRESS and 
ADDRESSCTRANSMIT) are equivalent in the potl statement. The poll 
list should be rebuilt when LINE CCONTROL KEY)= 1 (See VARIABLES> 


LINECCONTROL KEY)). 


RESTRICTIONS: 


‘le Every  <POLL ELEMENT LIST> entered in the same 
poll string must have the same total length. a 


2. Maximum Length of a <POLL ELEMENT LIST> is 15 
characters. | 


Se The. total tength of the pott string should not 

- . exceed the length specified in the <AUTOPOLL 

SIZE STATEMENT> in the line section. If it is 
exceeded» ENDOFBUFFER is set true. 
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4. The <POLL STATEMENT> should be executed only for 
| stations that are ready» valid» and enabled» and 
myuse must permit input. 


De Group poll: I f the system | includes 

~6©controller-stave stations (TU910 ~ TU510- #for 

example)» STATION CTYPE) should be checked to 
avoid polling stave stations. 


EXAMPLE: 


STATION := 1. 
DO FOREVERs | | 
IF STATION (VALID) AND STATION ‘CREADY) AND 
STATION CENABLED) AND CSTATIONCMYUSE):- NE 2) AND 
CSTATIONCTYPE NE 1) 
THEN POLL EOT» ADDRESS»POL»> 4™"2E™. 
IF ENDOFBUFFER THEN UNDO. 
IF STATION EQ MAXSTATIONS THEN UNDO> 
STATION:= STATION ¢# 1. 
END. a 


BURROUGHS CORPORATION 
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UJNDI STATEMENT 


<UNDO STATEMENT>? 2= 


<DO OPTION>::=_ 


SEMANTISS: 
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UNDO <DO OPTION>. 


<OD IDENTIFIER> 
<EMPTY 


Same as undo in REQUEST section. 


BURRDUGIS CORPORATION 
COMPUTE? SYSTEMS GROUP 
SANTA BARBARA PLANT 


TERMINAL SECTION 


<TERMINAL SECTION>::= 


<TERMINAL LIST>2:= 


<TERMINAL DEFINITION>?:? 


<TERMINAL DEFAULT> 
DEFINITION>:3= 


<TERMINAL ATTRIBUTE 
LIST2:= 


< TERMINAL AUTRUBUTE 
STATEMENT>ss= 


<TERMINAL IDENTIFIER>:: 


<TERMINAL DEFAULT 
IDENTIFIER>: := 


age | 
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<TERMINAL LIST> 


<TERMINAL DEF INITION> 


<TERMINAL DEF INITION> <TERMINAL LIST> 
<TERMINAL DEFAULT DEFINITION> <TERMINAL 
LIST> 


TERMINAL <TERMINAL IDENTIFIER>: 
<TERMINAL ATTRIBUTE LIST> 


TERMINAL. DEFAULT <TERMINAL ENE EEE 
STE RM ENKE ATTRIBUTE LIST> 


<TERMINAL ATTRIBUTE STATEMENT>. 
<TERMINAL ATTRIBUTE STATEMENT>. 
<TERMINAL ATTRIBUTE LIST>. 


<HEADER SIZE STATEMENT> 

<MAXINPUT STATEMENT> 

<TERMINAL ADDRESS STATEMENT> 

<TERMINAL DEFAULT STATEMENT> 

<TERMINAL DIAGNOSTIC REQUEST STATEMENT> 
<TERMINAL REQUEST STATEMENT> 

<TERMINAL TYPE STATEMENT> 

<TRANSMISSION NUMBER STATEMENT? © 


<IDENTIFIER> | 


<IDENTIFIER> 
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RESTRICTIONS: 


1. At Least one <TERMINAL | DEF INIT ION> must appear in the 
<TERMINAL SECTION>. 


2. A «TERMINAL DEFAULT DEFINITION> must predede = any 
 peference to it in a <TERMINAL DEFAULT STATEMENT>. 


3. The <TERMINAL DEFAULT STATEMENT> may appear in a 
<TERMINAL OEFINITION> but not in a <TERMINAL DEFAULT 
DEFINITION> (defaults may not de nested). 


SEMANTI2S: 


fie por wiaat section contains descriptions of every different type 
of remote device connected to the user's datacomm system. For 
example» if the system consists of 1C7500's and TD-/700's» two 
terminat definitions are required in the terminal section» one for 
the T2-500 and one for the 107700. This section is linked to the 
rest of the NOL program as follows: Terminals are associated with 
REQUZSTs by the <TERMINAL REQUEST STATEMENT> and the <TERMI NAL 
OLAGNOSTIC REQUEST STATEMENT>. A station is associated with a 
terminal definition by the <TERMINAL STATEMENT> in the STATION 
section. 7 | 
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ATTRIBUTE STATEMENTS: 


Only the <TERMINAL REQUEST STATEMENT> and the <MAXINPUT STATEMENT> 
are ansolutely requtred in every <TERMINAL DEFINITION>. Compiler 
warnings will be printed if the terminal address» reader sizes» 
type» and transmission number statements are omitted. 


TERMINAL DEFAULT DEFINITIONS: 


For terninals which have several common attributes» the common 
attributes can be grouped in a <TERMINAL DEFAULT DEFINITION>. The 
remaining attributes can be Listed explicitly under each individual 
<TERMINAL) DEFINITION>» and a <TERMINAL DEFAULT STATEMENT> wilt 
complet? the definition. : 


-. DEFAULT 
the exalicit attributes contained 


BURROUGIS CORPORATION 
COMPUTE? SYSTEMS GROUP 
SANTA BARBARA PLANT 


TERMINAL DEFAULT SEAT ERENT 


_— 


<TERMINAL DEFAULT 
STATEMENT>s3= 


SEMANTICS: 


This statement specifies: the identifier of a 
DEFINITION> . The attributes in the default are added to 


which this statement appears. 


RESTRICTIONS: 


a default attribute 


rn 
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DEFAULT = <TERMINAL OEFAULT IDENTIFIER> 


preceding <TERMINAL 


in the <TERMINAL DEFINITION> in 


conflicts with an 


1. I f. explicit 
attribute in the terminal definition» the 
explicit attribute is given precedence. 

Ce This statement cannot: appear in.a <TERMINAL DEFAULT 


DEF INITION>. 


the 
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Assume terminals Al» A2» and A3 have the same attributes. 


<TERMINAL OEFAULT STATEMENT> could be used as iilustrated below 
simplify the coding of the descriptions of these 3 terminals. 


TERMINAL DEFAULT A1230FLT: 


REQUEST (= TWXREAD?RECEIVEs THXWRITE? TRANSMIT. 
MAX INPUT = 72. 
ADDRESS = NULL. 
TERMINAL Al: — 
DEFAULT = A123DFLT. 
MAX INPUT = 95. 
TERMINAL A22 : 
DEFAULT = A123DFLT. - 
ADDRESS = 2 


TERMINAL A3: | 
DEFAULT = — = AL23DFLT. 


COMPUTER SYSTEMS GROUP B1700 NETWORK DEFINITION LANGUAGE 
SANTA BARBARA PLANT P.S. 2212 5223 
EXAMPLE: 


BF eas SE AE Tia AR, LT Pi tay Eat a RE ee I hag We 
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TERYINAL ADDRESS STATEMEN 


<TERMINAL. ADORESS | 
STATEMENT>2:= 7 ADDRESS = <RECEIVE ADORESS> 


<TRANSMIT ADDRESS PART> 
| ADDRESS = NULL 


<RECELV= ADDRESS>22= — <ADDRESS SIZE> 


TRANSMIT ADDRESS PART>:2=  <TRANSMIT ADDRESS> I<EMPTY> 


<TRANSMIT ADDRESS> 2:= <ADDRESS SIZE> 
<ADDRESS SIZE>2:= | 11213 
SEMANTICS: 


The <TEIMINAL ADDRESS STATEMENT> specifies the number of characters 
which are used to address a station associated with a terminal. An 


empty <TRANSMIT ADDRESS PART> implies the transmit address is of 


the same Length as the receive address. A non-empty <TRANSMIT PART> 
indicates that the transmit address may be nonwidentical to the 
receive address. If this statement is omitted» both address lengths 
are assumed to be zero. | 
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MAXINPUT STATEMENT - 


SYNTAX: 


CMAXINPJT STATEMENT>::= MAXINPUT = <INTEGER> 


SEMANTICS: 


The <MAXINPUT STATEMENT> applies only to inputs from the’ terminal 
and defines the maximum size (in characters) of an input message. 
The <INTEGER> must be less than 4096. This statement ts required in 
alt terminal definitions. 27 bytes for the header and 5 bytes for 
the trailer are added to the maxinput size to determine the input 
buffer length. | : 


High hse? A ee See Ee ed 


ae Hone be 5 ha — iit Ee pi cagt, Rink tains aie Wh ee Se 
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4EADVER SIZE STATEMENT 


SYNTAX: 


CHEADER SIZE STATEMENT>::= HEADER = <INTEGER> 


SEMANTI2S: 


‘The <HEADER SIZE STATEMENT> defines the expected size of the 


text header Ci.e. SOH""-STX) on input from this terminal. The 
<INTEGE2%> must be less than or equal to 27. Size 1s assumed to 
be zero if this statement is omitted. , 
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TERMINAL REQUEST STATEMENT 


<TERMINAL REQUEST - ; . 7 : 
STATEMENT>22= REQUEST = <REQUEST SPECIFIER LIST> 


<REQUEST SPECIFIER LIST>::= <INPUT SPECIFIER> 

; | 1 <OUTPUT SPECIFIER> | | | 
: = 5 a _ t <INPUT SPECIFIER>» -<QUTPUT SPECIFIER> 
ye _ & «8 <QUTPUT SPECIFIER>» <INPUT SPECIFIER> 


<ENPUT SPECIFIER> ae? <REQUEST IDENTIFIER>: RECEIVE 


sO UErUd SPEC IFIERD?: — SREQUEST IDENTIFIER>: TRANSMIT 


SEMANTICS: 


This required statement Links the terminal with one of two line 
disciplines CREQUESTs). When input is to be received from a 
stations the station's terminal-table entry is checked and the 
REQUEST identified in the <INPUT SPECIFIER> is called. 
Similarly on output» the REQUEST from the <QUTPUT SPECIFIER> jis 
called. ? | 


The <REQUEST LIST> may speci fy either the input REQUEST or’ the 
output REQUEST» or both. The same REQUEST can be used for both 
input and output. For example: 


REQUEST = LOTTY33:RECEIVEs IOTTY33: TRANSMIT. 


Hy 4 
‘| 
1 
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TRANSMISSION NUMBER STATEMENT 


<TRANSMISSION NUMBER 


STATEMENT> 22 = : TRANSMISSION = <TRANSMISSON NUMBER> 
<TRANSMISSION NUMBER>?2= Of 29 2 4 3 1 NULL 
SEMANTICS: 


The <TRANSMISSION NUMBER STATEMENT> specifies the length of the 
transmission number. The number zero and NULL are equivalent and 
specify that no transmission number wilt be used- A  nonNULL 
transmission number must be specified if the item "TRAN™ is 
mentioned in a REQUEST of the terminal. 


TERMINAL DIAGNOSTIC REQUEST STATEMENT 


<TERMINAL DIAGNOSTIC | 
REQUEST STATEMENT>::= | DIAGNOSTIC = 


<REQUEST SPECIFIER LIST> 


SEMANTI<S: 


This optional statement specifies an alternate REQUEST that can be 
used for diagnostic reasons. A “DCWRITE"™ from the MCS is required 
to inttiate the diagnostic REQUESTs. 
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TERMINAL TYPE STATEMENT 


SYNTAX: 
<TERMINAL TYPE STATEMENT>:2= TYPE = <TYPE NUMBER> 
<TYPE NJMBER>:2= EN TEGER> 


SEMANTICS: 


On input messages» an eight~bit field in the message header is 
automatically set to the terminal type specified for this current 
station. The value of <TYPE NUMBER> must be less than 64. The 
following hardware terminal types are recommended. 


1 = TC500 
2 = CONRAC CWIDE) 
3 =. RT2000 | 
4 = TOUCH TONE 
5 = TU300. 
6 = T€3500 
¢ = DC140 
8 — 104000 
9 — TO5100 
10 + £4== T1102 
Li = TC7090 | 
12 = CONRAC (NARROW) 
13 = DC110 ©. 
14 = TELETYPE 
15 = TU400 
21 = ~T¢1700 
22 = BIDS 
25 = TU500 
32 = TD700 
35 = TU700 
he = T0800. 
45 = TU 800 
b2 = 31700 
a3 = 


~Be700 
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The user» howevers has the option of assigning any hardware type and 
this will be passed in the message header. If this statement does 

not appear tna terminal definition» a compiler warning will be 
printed and type will be assumed zero. . : : 


oy 
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STATION SECTION 


<STATION SECTION>:2= 


<STATIOV LIST: 2= 


<STATION DEF INITION>::= 


<STATION DEFAULT 


DEFINITION>: z= 


<STATION ATTRIBUTE LIST>: 


<STATION ATTRIBUTE. 
STATEMENT>:3= 


<STATION IDENTIFIER>?:= 


<STATION DEFAULT 
IDENTIFIER>? := 


ome | 
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<STATION LIST> 


<STATLION DEFINITION> | | 
<STATION DEFINITION> <STATION LIST> 
<STATION DEFAULT DEFINITION> <STATION LIST> 


STATION <STATION IDENTIFIER>: 
<STATION ATTRIBUTE LIST> 


STATION DEFAULT <STATION 
DEFAULT IDENTIFIER>: 


SSTATION ATTRIBUTE LIST> 


<STATION ATTRIBUTE STATEMENT>. 
<STATION ATTRIBUTE STATEMENT>. 
<STATION ATTRIBUTE LIST> 


<CONTROLLER STATEMENT> 
<FREQUENCY STATEMENT> 
<LOGICALACK STATEMENT> 
<MCSQUEUE STATEMENT> 

<MYUSE STATEMENT> 

<RETRY STATEMENT> 

<STATION ADDRESS STATEMENT> 
<STATION DEFAULT STATEMENT> 


<STATION TERMINAL STATEMENT > 


<IDENTIFIER> 


<IDENTIFIER> 
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RESTRICTIONS: 


le At least one <STATION DEFINITION> must: appear in 
the <STATION SECTION>. : 


(2. A <STATION DEFAULT DEFINITION> must precede any 
reference to it in a <STATION DEFAULT 
STATEMENT>. 


3-2 The <STATION DEFAULT STATEMENT> may appear in a 
<STATION DEFINITION> but not in a <STATION 
DEFAULT DEFINITION> (no nested defaults). 


SEMANTICS: 


Each individual remote device in an NOL system must be defined in 
the station section. AS in the’ terminal sections default 
definitions are provided as a coding aid. 
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Cuabaaiecaatatis STATEMENT 


SYNTAX: 

cCONTROLLER STATEMENT>::= | CONTROLLER = <STATLON CONTROLLER 
TYPE> 

<STATION CONTROLLER TYPE>::= TRUE 
FALSE 


<STATION IDENTIFIER> 


SEMANTI- 25 


The statement is only required for stations that are part of a 
CONTROLLER SLAVE station configurations, tike TU910 - TU510%s. The 
<CONTRO_LER STATEMENT> makes it possible to use group potling In 
the tine CONTROL (See <POLL STATEMENT>)- A station's CONTROLLER 
Status can be accessed at runtime by using the variable 
STATILONCTYPE). 


CONTROLLER TYPE MEANING 
IRIE. This station 1s a controllers like TU910. 
FALSE _ oe | This station is a regular remote device. 


This ts the default value. 


<STATION LDENTIFIER> This station is a slaves Like a TUSLO>» ~ 

3 | and <STATION I[DENTIFIER> is its controtler. 
<STATION IDENTIFIER> must refer to 
a preceding station definition. | 
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FREQUENCY acai 


SYNTAX: 
 <FREQUEVCY STATEMENT>22=__ FREQUENCY = <I0 FREQUENCY> 
<1O FREQUENCY>22= -° <INTEGER>»< INTEGER> 
| | | <INTEGER> 
SEMANTI2S: 


The <FRIQUENCY STATEMENT > specifies a priority for tnput and output. 
for us2 by the station in the Line CONTROL section. The maximum 

number which may be specified is 255. The first integer defines the 
input oriority and the second integer defines the output priority. 
The default value 1s zero. | 


EXAMPLE: 
FREQUENCY = cre 
FREQUENCY = 5. 


LOGICALACK STATEMENT 
<LOGICA.ACK STATEMENT>=?: = LOGICALACK = <LOGICAL VALUE> 
SEMANTI2S: 


Tae Gere uae if the REQUEST 1s actually to be interrupted. 


If this statement is omitted> LOGICALACK defaults to "FALSE". 


BURROUG4S CORPORATION 
COMPUTE? SYSTEMS GROUP 


SANTA BARBARA PLANT 


4CS QUEUE STATEMENT 


<MCSQUEJE. STATEMENT>22= 


<QUEUE NAME> i= 


<QUEUE 7AMILY>22= 


<QUEUE JFFSPRING>??= 


 SEMANTI2ZS: 


This statement informs 
user's datacomm system» 
It is required if and only 
name used by the MCS queue 
FAMILY> is tleftjustified 
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MCSQUEUE = <QUEUE NAME> 


<QJEUE FAMILY> 
<QUEUE FAMILY> <SLASH> < QUEUE OF F SPRING> 


<EBCDIC STRING> 


<EBCDIC STRING> 


the NC of 1) the presence of an MCS in the 
and 2?) the name of the MCS*s tnput queue. 
if an MCS is to be present. The actual 
is a 20-character field. The <QUEUE 
in the first 10 characters» while <QUEUE 
OFFSPRING> is left-~justified in the second 10 characters. Ex amoles: 


~MCSQUEUE = "USERSMCS"/ "INPUTQUEUE™. 


MCSQUEUE = “MCSIN"™. 


If the user intends to 
Burroughse set MCSQUEUE to 


For the V.0 release» this 


the ILLUSTRATIVE MCS supplied = by 


"MCS.QUEUE™. 


statement need only appear once mn the 


station section» in any station definition. 


See a ee eae Sy ES aces = eee Sere hg ee ats Sea ae nS ee ome Cig See eT ne eee eee BAe eye ee eee Reba is sess: 


—_ ee ae i i i te A RI Th te rr a A re rr an li nm a ee 
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MYUSE STATEMENT 


SYNTAX: 
<MYUSE STATEMENT>?:= MYUSE = <I0 LIST> 
c<IO LIST>:t= INPUT 
| 1 OUTPUT 
| INPUT» QUTPUT 
| QUTPUT» INPUT 
SEMANTICS: 


This required statement specifies the allowed use of a  station-- 
input» outputs» or both. It should be consistent with the <REQUEST 
STATEMENT> of this station's terminal definition (See terminal 


REQUEST statement) and with the I/0 initiation in the tine CONTROL 


(See <ZONTROL INITIATE STATEMENT>). MYUSE can be changed at 
run-time by an MCS communicate. The MYUSE status can be checked at 
runtime by accessing the vartable STATIONCMYUSE). | 


10 _IST STATION CMYUSE) VALUE 
[NPJT 1 
OUT? UT 2 
INPJT» OUTPUT 3 
Z 


OUTPUT.» INPUT 


oF ey ee ee ee ee Se eo eer eee eee =e: — > = 
225" _ Sk ee eg es ee ee ee Et Fees aloe Bk ESE ns DC Re ES Er Me eS SOOM Re Bet SRT dog Ft SCRE SET SE Str IO SORE abcde OF ibs CESS tks FS Pa. 


rab RR ARETE SEARS RS BTS BS SSS EE REE Oe SS PT SER Eg Sh a SEE ee SE 45 8 a BS SES Et ee ERIS SDE ES Ee SSS 7 - ; -_ oo 


| 8-7 
BURROUGIS CORPORATION os COMPANY CONFIDENTIAL 


COMPUTE? SYSTEMS GROUP B1700 NETWORK DEFINITION LANGUAGE 
SANTA. BARBARA PLANT PeS- 2212 5223 


RET?Y STATEMENT 


<RETRY ane ancien RETRY = <INTEGER> 


aes S: 


The CRETRY STATEMENT> gives Ris initial retry count for the station. 
At run times the value may be changed by the MCS or by INITIALIZE 


RETRY in a REQUEST. The <INTEGER> must be less than 256. 


Si a en ee Se es eee ae sr Es aye 
ae 2S Ss ee ae Pep tebeg Sede Stee Se gee eee ee SS ca Bac as are ocd dsc ee eer Shas ree eee ae RTE S ote a Pte eee ee at S- Fis AT Figs oS LSP es SG EES OTE a BT per ee ae er ee Sg ot grt eee Ape ESL 
Bae Sie Sates Bee ae cn ae ee ki ae Rett g erate Ge ar ioe ee gee bees ew 
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STATION uhcabe STATEMENT 


SYNTAX: 


<STATION ADDRESS | 7 
STATEMENT> 22 = | ADDRESS = <STATION ADDRESS LIST> 


<STATION ADDRESS LIST>2:= <RECEIVE- TRANSMIT ADDRESS> 


1 <RECEIVE ADDRESS>» <TRANSMIT ADDRESS> 


<RECELVZ7*TRANSMIT 


ADDRESS> 3:22 <EBCDIC STRING> 
<RECELV= ADDRESS>:: <EBCOIC STRING> 
<TRANSMIT ADDRESS>2:2= <EBCDIC STRING> 


SEMANTICS: 


The. <STATION ADDRESS STATEMENT> 1s used to specify the address of a 
station for operations such as polling and setecting. If no. 
<STATION ADDRESS STATEMENT> is defined for a stations the mode of 
the associated terminal must be contention. The length of the 
address specified must be equal to the length as defined in the 


<TERMINAL ADDRESS STATEMENT> of the associated terminal. 


An address pair should be de fined onty if the station*’s receive and 
transmit addresses are different. The first member of an address 
pair is the receive address» the second the transmit address. 


Examples: 


ADDRESS = "01". 


i 


ADDRESS "O10", "011". 


ON A ART SE ie SESS SS SES te acre ae EA ee eee Pe re ee a a a ee Ee 
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STATION DEFAULT STATEMENT 


SYNTAX: 
<STATION DEFAULT 7 7 7 
~~ STATEMENT>22= : DEFAULT = <STATION DEFAULT IDENTIFIER> 


SEMANTIC S: 


The <STATION DEFAULT STATEMENT> is used in the same manner that a 
<TERMINAL DEFAULT STATEMENT> is used. The <TERMINAL DEFAULT 
STATEMENT> is discussed under the description of terminal default 
semantics - | - 


STATION TERMINAL eae 


SYNTAX: 


~-— 7 «a 2 a am om ‘ 


<STATION TERMINAL | | | _ 
STATEMENT>2:= TERMINAL = <TERMINAL IDENTIFIER> 


aE NANT: 3: 


‘This statement is required in every <STATION DEFINITION>. The 
<STATION TERMINAL STATEMENT> specifies the name of the terminat 


description which defines the physical characteristics of the 
station being described. More than one station description may 
reference the same terminal description. | 
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: 
LINE SEDTION 
SYNTAX: 
c<LINE S: CTION>S ' <LINE LIST> 
<LINE LIST>:¢= <LINE OEFINITION> 


1 <LINE DEFINITION> <LINE LIST> 
1 <LINE DEFAULT DEFINITION> <LINE LIST> 


 <LINE JEFINITION>?2= | LINE <LINE IDENTIFIER>: 
oe | <LINE ATTRIBUTE LIST> 


<LINE DEFAULT DEFINITION>::= LINE DEFAULT Cpa DEFAULT 
| a IDENTIFIER>: 
<LINE ATTRIBUTE LIST> 


<LINE ATTRIBUTE LIST>::= <LINE ATTRIBUTE STATEMENT>. 
| : . : 1 <LINE ATTRIBUTE STATEMENT>. <LINE 

ATTRIBUTE LIST> 
<LINE ATTRIBUTE | 5 ». * 
STATEMENT>3:= | <AUTOPOLL SIZE STATEMENT> 

3 1 <LINE ADDRESS STATEMENT> 

1 <LINE CONTROL STATEMENT> 

1 <LINE DEFAULT STATEMENT> 

1 <LINE STATION STATEMENT> 

1 <LINE TYPE STATEMENT> 

1 <MAXINWORK STATEMENT> 

{ <MAXOUTWORK STATEMENT> 
<LINE ILJENTEFIER>? 25  <IDENTIFIER> 
<LINE DiFAULT 
[DENTIFIER>: 2= <IDENTIFIER> 


eal 
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RESTRICTIONS: 


- At least one <LINE DEFINITION> must appear in 
the Line section. 7 


2. A <LINE DEFAULT DEFINITION> must precede a 
| reference to it in a <LINE DEFAULT STATEMENT>. 


3. The <LINE DEFAULT STATEMENT> may appear in a 
«LINE DEFINITION> but not in a <LINE DEFAULT 
DEFINITION> (defaults may not be nested). 


he The <LINE STATION STATEMENT> may not appear in 
<LINE DEFAULT DEFINITION>s. A station may only 
be on one tine. 


De The <LINE ADDRESS STATEMENT> aay not appear In 
<LINE DEFAULT DEFINITION>s. 


SEMANT IOS: 


Fach line in an NOL system nust be described in the Line section. As 
in the terminat sections default definitions are provided as a 
coding aid. 7 
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AUTOPOLL SIZE STATEMENT 


SYNTAX: 


<> a Gp aD 80 a) 


CAUTOPO.L SIZE STATEMENT>::= AUTOPOLL = <INTEGER> 


SEMANTICS: 


The <AUTOPOLL SIZE STATEMENT> defines the maximum size in characters 
of an autopoll buffer. This buffer will contain the poll list for 
the line as supplied by the Line CONTROL section through the use of 
the "PO_L™ syntax. The maximum value of <INTEGER> is 1023. | 


BURROUGIS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


<LINE A)DRESS STATEMENT>::= 


<LINE ADRESS LIST>?2:= 
<LINE A)DRESS>2: =. 


<PORT. NJIMBER>23= | 


<CHANNE. ADDRESS>322= 


CADAPTE? ADDRESS> 2:2= 


COMPANY CONFIDENTIAL 
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<LINE ADDRESS LIST> 


<LINE ADDRESS> 


<LINE AODRESS> » <LINE ADDRESS LIST> 


<PORT NUMBER> = <CHANNEL ADDRESS> =: 


<ADAPTER ADDRESS 
O119121394151617 


01112131415161718191101 
LLi§i2'13sir~4i15 


OILi293'41516171819010 
111129135014115 


SEMANTICS: 


Required for each Line» the tine address statement 1s used to 
specify the port numbers» the channel number and the adapter number 
within the channel to which the tine ts attached. Two lines may not 
have tha same address. Example: mS | 


ADDRESS = 220215. 
[his statement would appear in the tine description of the Line 
which is connected to channel number zero at adapter number 15 _ of 


port nunber two. 


With switched lines» a particular line may have several alternate 
address2s. The addresses will be checked in the order Listed. 


et ER NR SEARLS AS 1 BE be BGG ES OS BAG GES SEES EE TE. 


Bt a Os tes 5a) Wee an eC aay SO eto Std SEs ae sds hak eee ah Sieh bree Ack roe Se os cia hee oo eek 5 cites pipes eae ee: ee se ee 
= MEM SEDER SE! 1 Mb cee ek cele here SSNS SPS a eeed tele sus cateee phefeeet erergheer ne. et pean s PES 
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LINE CONTROL STATEMENT 


<LINE CONTROL STATEMENT>::= CONTROL = <CONTROL IDENTIFIER> 


SEMANTICS: 


This required ea bomene associates a CONTROL procedure with this 
Line. The <CONTROL IDENTIFIER> must have been defined tn the 


CONTROL section. 


LIN: DEFAULT STATEMENT. 


<LINE DIFAULT STATEMENT>::= DEFAULT=<LINE DEFAULT IDENTIFIER> 


SEMANTICS: 


The ss asaiepiuad STATEMENT> is used in-~ the same manner that a 
<TERMINAL DEFAULT STATEMENT> is used. The  <TERMINAL DEFAULT 


STATEMENT> ts descussed. under the description of terminal default 


semantics. 
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“<LINE STATION STATEMENT>:2= STATION = <LIST OF STATIONS> 


<LIST OF STATIONS>::= ©  <STATION IDENTIFIER>- | 
- 1 <LIST OF STATIONS>» <STATION IDENTIFIER> 


SEMANTICS: 


Required for each Lines the <LINE STATION STATEMENT> tdentifies the 
stations ona tine. Lines designated as passive must not have a 
<LINE STATION STATEMENT>. A station may be associated with only one 
line and may not be defined twice for the same tine. <STATION 
IDENTIFIER> must have been defined in the STATION section. 


Soa ST art ke See ee Meee tee erage igs 


BURROUGIS CORPORATION 
COMPUTE? SYSTEMS GROUP 
SANTA BARBARA PLANT 


LIN: TYPE STATEMENT 


<LINE TYPE STATEMENT>: == 


SEMANTICS: | 


passive type statement. 


This statement is optional and if 
considered active and its type determined through the hardwaree 


EXAMPLE? 
LINE L1: 


ADDRESS = 
CONTROL = 
STATION = 


COMPANY CONFIDENTIAL 
B1700 NETWORK DEFINITION LANGUAGE 


Pe 


TYPE = 


A tine nay be declared in NOL but kept 


42231. 
AUTOPOLCTIL. 
Bil. 3 


TYPE. = PASSIVE. 


Se 2212 


PASSIVE 


onitteds 


5223 


the 
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MAXI NWORK ST ATEMENS 


MAXINWORK = <INTEGER> 


es 
ee 
H 


Sa diab bok oe 


Defines the maxium size in bytes of. an input workarea for the Line. 


It should be set just targe enough to contain the longest CONTROL 
message expected from any station on the tine. The workarea 15 
located within baserto-limits» in the tine table- Workarea is 
intended to be used only to accept CONTROL message (See “INITIATE 
RECEIVE (C(CONTROL)" ue the REQUEST section)» since text would 


overflow ite 


Notes CINTEGER> may not exceed 27. The default value is zero. 


MAX IUT WORK STATEMENT 


<MAXIUTAORK STATEMENT >22= MAXOUTWORK = <INTEGER> 


SEMANTICS: 


<MAXOUTWORK STATEMENT> defines the maximum size. of an output 


workarea for the Line. This output workarea may be used (for. 


transmitting CONTROL messages to a station such as *ACK™ using the 
syntax "TRANSMIT ACK™ "FINISH TRANSMIT™ in the REQUEST section. The 
<INTEGE?2> must be at least as large as the maximum size of any 
header sent with a message on the line (i.e. SOH «© «© «-« STX) and 


must not be greater than 27. The default value is 0. 
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FILe SED TION 


SYNTAX 
<FILE SiCTION>22= | | <FILE LIST> 
<FILE LIST>2:= ss <F ILE DEFINITION> 
| BS | t <FILE LIST> <FILE O€FINITION> 
| <FILE DEFAULT DEFINITION> <FILE LIST> 
<FILE JEFINITION>?2= <FILE IDENTIFIER>2<FILE ATTRIBUTE LIST> 


| <FILE DZFAULT 
| DEFINITION>?:= |, FILE DEFAULT <FILE DEFAULT IDENTIFIER>: 


<FILE ATTRIBUTE LIST> 


cFILE ATTRIBUTE LIST>22= <FILE ATTRIBUTE STATEMENT>. 
: | _ 1 <FILE ATTRIBUTE LIST> 
<FILE ATTRIBUTE STATEMENT>. 


© <FILE ATTRIBUTE ~ 

) STATEMENT> 33 = <FAMILY STATEMENT > 

: | 1 <FILE DEFAULT STATEMENT> 
3 | i <FILE RESIDENT STATEMENT> 


<FILE DJENTIFIER>E2= <IDENTIFIER> 


<FILE DZFAULT | 
LOENTIFIER>? 2= | <IDENTIFIER> 
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RESTRICTION: 
The <FILE OEFAULT STATEMENT> may appear. in <FILE 
4 DEFINITION>s but not in <FILE © DEFAULT DEFINITION>s 
| (DE-AULTS may not be nested). <FAMILY STATEMENT> may not 
app2ar ina <FILE DEFAULT DEFINITION>. 
, SEMANTI2S: 
| The fil2 section associates stations that are part of an NOL network 
| with remote files of user programs. 
| FILE DEFAULT STATEMENT 
SYNTAX 


— @ <Fice DEFAULT STATEMENT>::= DEFAULT = <FILE DEFAULT IDENTIFIER? 


SEMANFICS: 


Ht “7 3 ee ee ee eS ee 


The <FILE DEFAULT STATEMENT> is used in the same manner that a 
<TERMINAL DEFAULT STATEMENT> is used. The <TERMINAL DEFAULT 
STATEMENT> is discussed under the description of terminal default 


semantics. 


eb 
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FAMILY STATEMENT 


SYNTAX: 


cFAMILY STATEMENT>2:= FAMILY = <STATION FAMILY> 
<STATION FAMILY>22= STATION IDENTIFIER LIST> 
| | 1 DUMMY 

<STATION IDENTIFIER 

LIST>:2= “STATION IDENTIFIER> , 
1 <STATION [DENTIFIER>» <STATION 

IDENTIFIER LIST> 
SEMANTICS: 


The <FAMILY STATEMENT> Lists the names of stations which are to be 
considered members of the file being described. A station can be 


associated with any number of files and it can also be referenced 
any number of times in any one file. If DUMMY is used» it means 


that (1) an MCS must assign the stations to be associated with the 
file at open time and» (2) the number of stations assigned must be 


equal to or tess than the number of stations declared in the file 
statement of the opening user programe | 


AER RGAE AN Pa itt RN ELE MASE eA gS AN Ede ae wR abeebictel Mtg Ee lect ee 2812 SATE a te NAPE BR MAE FMM ALS YP alee 
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ibe RESIDENT STATEMENT 


<FILE RESIDENT | oe 
STATEMENT> 22= : | RESIOENT 
1 RESIDENT 


CORE 
DISK 


iil 


SEMANTICS: 


The fil2 resident statement igen the user program in_ core 1 f 
resident equals core. Otherwiser it is oaged out after each remote 
file read or write. The default is RESIDENT = CORE. | 


tLe SY eer een ayer ones arcs 
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NDL LIBRARY 


The Net work Definition Language (NDL) Library consists of procedures 
used i1 the operation of on-line terminals that interface with 
B1i700-Series computers. NOL Library is a source language library 
that contains the REQUESTs and CONTROLS necessary to handle common 
Line disciplines for the terminal devices referenced hereitn.e By 


utilizing the library» users should find it unnecessary to write 


their oan REQUESTS and CONTROLs.- 


ACCESSING | THE LIBRARY 


The Library of line desciplines described herein is a released 
product in the NDL system and ts named "NDL/LIBRARY™. | 


This lLiadrary consists of a number of groups of source statements 
coded in NDL (Network Definitton Language)» each group constituting 
a togical entity. These groups fall into two classes: those called 
REQUESTS and those called CONTROLs. 


Including the appropriate $ LIBRARY statement in a compile deck 
places any of these entittes» tntact» into an NOL compile. For 
instance» "$ LIBRARY POLLTDO700%- when placed correctly in a 
compilation deck passed to the NOL compiler» will cause all source 
statements in the entity named POLLTO700 from the NOL/LIBRARY files 
to be itcltuded into the source passed to the compiler. 


A typical compilation deck wilt appear as follows: 


27CO¥4PILER HANDLER WITH NOL TO LIBRARY: 
2DATA CARDS — 
DECLARATION: 
NIF= "HANODLER™/"NIF". 
S$LI3RARY POLLTD700 — 
$LIZ3RARY SELECTO700 
SLIZRARY POLSELCTL 
<TERMINAL SECTION STATEMENTS> 
<STATION SECTION STATEMENTS> 
<LINE SECTION STATEMENTS> 
<FILE SECTION STATEMENT S> 
FINI. 
PEND; 


 BURROUGIS CORPORATION. 


D SANTA BARBARA PLANT ome 


wills 
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This deer. with the <SECTION STATEMENTS> appropriately filled in 
with the aid of an applications program» communicate to a 
network composed of either T0700 or [0800 terminals» or some 


combination of both. 


Note: The $$ LIBRARY cards take’ the olace of NOL 

executable statements in the deck. The 

compiler will replace these $ LIBRARY cards 

with actual source statements found. in the 

NDOL/LIBRARY file under the entity named 
POLLTD7090 or SELECTD/700 etc. 


25 
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ASSOCIATIVE WAR ECE. 


. REQUESTS VS. CONTROL 


| 7 | 
7 | CONTROL | | 
: a hE ek ea REE ERE EEE REE EERE EERE EE ERE ERE EE REE EK EREEEAES 
2 * 1 ms ? vn Zz k ly k 5 k 6 a 
, cahenwwevwee twee adie stawns tea ee ree eete ee seeeen ss seer ees ees seer ee Tee: 
, POLLTCTID * x X aan a * 
: | ee ik & & x & k 
: POLTCTDODYN* “ * , : oe w | 
: | a * * te * ke & 
READTTY: *- & t X * * i * 
| | k * & ot * ‘te & 
: TOSPTRCV. * * X * te * k 
R te * te | * & & & 
To7PTz%cv * * * K k « rs re 
E * | * & * & te tt 
SELECTCTD * X * X * * & « x x 
Q « x : & * &e * & 
© FASTS= LTCD* X * x * # ‘ & « 
U & * & | ke * & te 
WRITETTY * * & X * 
F a 4 te k k k ms 
TCSPTXMIT * i X . 5 7 
| S | k * & * & ie 
TO7PTXMIT * t | * X te k ve rf 
I - ie & | a & re « & 
TCOPT?LS = * * * * X * x * 
| & kk * é | « te tk 
DIAGTCTOIO* xX * K * * * * fe 
ok & & « hk & * 
RJE ot tk te co te X * 
Lhe eKEAR OWREE ERED ERE SERS SORE WEEPER ROE RES A HE EERE SE SERS EERE EE SESE SESS 
CONTROLS. 
1 = POLSELCTL X = RECOMMENED USAGE 
2 = AUTIJPOLCTL | 
3 = PTPTCONCTL 
A = CONVERTL 
5. = RIJECTL 
6 


AUTIDYNC TL 


ee Be et SE EE Er eh 
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REQUEST VS. TERMINAL 


TERMINAL. | 
kkk kkk hkkkkkkkkak kk kkakkkk kk kk ke kkkkkk kkk kkk kkkkhkk kkk 
*« TC500 * ot k | ok * 
* T0700 * TDO70) * we * REMOTE * 
* T03500 * TD800 * FUSOO * TELETYPE * APPLICATIONS * 


kKhekkkkkkk kk kkkkkkkkkk kk kkk kkk kK KEK KK KK KK KKeKKKK kk kkkkkk kk kk kk kt k 


POLLIZTD « X x fe X fe * ik 

* | ot k | re | 

POLTCTODYN®« X * X Xx ix * 

| | ae te * * ke rs 
READTTY. « fe hk X . & * 

. * * * * *« & 
TCSPFRCV «& Xx & i * * & 

te * k * fe k 

TOCPTRCVY « Pe X ke * a: te 

R BD & * re * ry x 
SELECTCTO « X k X & X & k ‘« 

E | _ « * * te & 
FASTS=LITCD« X & 4 rs X « ms * 
Q. & * * * x te 
WRITETTY « & ~« * X * & 
ae te * * * rs te 
TCSPTXMIT * xX te tk tk * k 

E. * * te rs * * rs 
FO7PTXMIT «* te X & i * 
3 | * k | i te & te 
TCOPT?I10 t X- & * * & k 

T. * | * k ra k k 
DIAGTITODIO« X * XxX & x te * i 

| * a ee * tk te * 
RIE | 7 * * ke x a ve 

te 


kek kkk kkk Kk kkkkkkkkkk kk kkkkkkkkkkkkkkkkkkkkkkkkkk kkk kkkkkkkkhkk 


X = RECJMMENDED USAGE 
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USING T4£ NDL COMPILER + 


Controt card deck to compile a Network Controller with the NDL- 
| compiler is as follows: Pi 


9CUMPILE MYHANDLER WITH NOL TO LIBRARY 
2DATA CARDS | 


Note: "2?" indicates an invalid punch in column 1 for 80-column cards. 


* Section will be completed at a later date. 


Lene 
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COMPILER INPUT AND QUT PUT FILES 


EXTERNAL NAME INTERNAL NAME MEDIUM _ USE 


CARDS ; CARDS CARDS Primary. 
: source input 
SOURCE = | | ~ SOURCE | | DISK Secondary source 
| a input 

NEWSOJRCE NEWSOURCE . OISK New secondary 

| —_ | | source Cout put) 
LINE | LINE ss PRENTER = Listing 

NOL/NEIF — © | | NIF | DISK Qutout network 


information file 


NDL ADDRESS ADDRESS | DISK Address file 
| | output by MACRO for 


compiler Cinput) 


(USER-CHOSEN) OBJECT DISK Object code file 
| | of user's handler 
NDL/MACRO MACRO DISK Skeletal controller 
| | code file Cinput) 
AUDIT .FPBS AUDIT.FPBS DISK Workfile 
NOL/LIBRARY LIBRARY OISK Standard request 


and control source 
code library 


CODE ae “cope DISK Workfile 


Note: NDL/MACRO . and NOL/ADDRESS must be present on disk at 8 OJ of 
the compiter. SOURCE (Cor user's label~equated file) must be 


gresent if SMERGE is used. NOL/LIBRARY must be present i f 
are part of the release package. 


L2> 5 
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NDL SOURCE FORMAT 


The fornat of the NOL. source record is as follows: Card columns 1772 
inclusive are the free form source field. Cotumn 72 is togicattly 

adjacent to column 1 of the next card» so identifiers» numbers» 

strings» etc. may be continued on the next card. os 


Card columns 73-80 are reserved for sequence numbers» if desired. 


Comments: Occurrence of a percent sign (2%) In columns 1772 results 
in the compiler skipping to column 1 of the next card. Any 
desired comment text may b2 entered following the i a 
Percent signs are part of the NOL sourcer howeversr if they 
appear within an <EBCOIC STRING>.- For example: . oe 


FETCH CHARACTER. % ANY COMMENT. . . 
TRANSMIT “LEGAL 2". % PERCENT WITHIN QUOTES IS LEGAL 
% THIS WHOLE CARD IS COMMENTS. . « 


A dollar sign ($) in column 1 signals the compiler that the card 


contains compiler CONTROL statements (See next section). 


SR RE Re RR PE SR ESE ES BE SA ROR ASSESS aes esa ee OES Le RA Reto dis ea Seg eS SEE A a ed ES es, ee a eS cae 2 
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COMPILER CONTROL STATEMENTS 


Compiter execution options are specified by means of primary source 
records with a dollar sign ($) in column. 1- The options cover” the 
areas of List format. error/warning handling» source. maint enancer 
changing stack sizes» and accessing the NDL source code library. 


SYNTAX? 


<COMPILZR CONTROL i | 
STATEMENT> 33 = | | <"s" IN COLUMN 1> <OPTION LIST> 


<OPTLON LIST>::= <OPTION> t NO <OPTION> 
7 1 <OPTION> <OPTION LIST> 
1 NO <OPTION> <OPTION LIST> 


<OPTLON>22= | CHECK 

| CODE 
‘CONTROL 
<DBUG. QPTION> 
DOUBLE 7 
FORGETERRORS 
List 
LST 
MERGE 
NEW 
<SEQUENCE OPTION> 
SGL 
SINGLE 
<STACK SIZE OPT ION> 
SUPPRESS | 
<LIBRARY OPTION> 
<VOIDO UOPTION> 


<DBUG OP TION>?:= — —— DBUG <DBUG LIST>. CNON-RELEASE) 
<DBUG LIST>??= CINTEGER>I<INTEGER>> <DBUG LIST> 
<SEQUENCE OPTION>::= ss SEQ <SE@ BASE> <SEQ INCREMENT> 
<SEQ BASE>22= “<INTEGER>I<EMPTY> 


<SEQ INCREMENT>2 == | t<INTEGER>I<EMPTY> 


BURROUG4S CORPORATION 
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<HIGH SZ QUENCE> 


SEMANTICS: 


CODE. 
CONTRIL 
CS$iz: 

D3UG 

DOUBL: 
DYNAMECSIZE 
ESSIZ= | 
~ FORGETERRORS 


LIBRARY 


LIST. 


—Lst 


-<STACK SIZE OPTION>::= CSSIZE <INTEGER> 


DYNAMICSIZE <INTEGER> 
NSSIZE <INTEGER> 
PPSSIZE <INTEGER> 
ESSIZE <INTEGER> 
VSSIZE <INTEGER> 


LEBRARY OPTION>=::= LIBRARY <STANDARD IDENT IFIER> 
<STANDAZVO IDENTIFIER>: == <IDENTIFIER> 
<VOIO OP? TION>::= VOID 1 VOID <HIGH SEQUENCE> 


ee <B-“CHARACTER INTEGER> 


Print warnings on sequence errors. A sequence error 
occurs when sequence of last card is greater than or 
equal to the current sequence number . 


List generated SDL“Machine S7OPS. 


List "8" cards 
Set CONTROL stack size of NC to <INTEGER> entries. 


Non-releasee Compiler debugging options. 


Deublespace Listing. 

Set NC's dynamic memory to <INTEGER> bits. 

Set NC's evaluation stack size to <INTEGER> entries. 
sancewts object NC despite syntax errors. 

The NOL cource code specified by <STANDARD [DENTIFIER> 


is retrieved from the file "NODL/LIBRARY™ and inserted in 
the user's program following the "LIBRARY™ card. 


List source. 


List source. 
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“MERGE Merge input Cpatches in “ PCARDS™) with secondary 
input C"SOURCE™). | | | : 
NEW Output a new secondary source file C"NEWSQURCE™). 
NSSIZ: Set NC*s name stack size to <INTEGER> entries 
PPSSIZE | Set NC's program pointer stack size to <INTEGER> 
—- entries. , | | | 
SEQ sequence the source beginning at <SEQ BASE> and 
incrementing the sequence number by <SEQ INCREMENT>. 
Default is "SEQ 00000000 +100° (specified by just "SEQ™) 
Sal Single-space lasting 
SINGL: Single-space tltsting 
| SUPPR=SS Syntax warnings will not be printed. 
VSSIZ= Set NC's value stack to <INTEGER> bits. 
VOID If <HIGH SEQUENCE> is not specified» only the secondary 


source record with the current sequence number is 
Skipped by the compiler. otherwise» skip all secondary 


source records beginning at current sequence number and 


continuing tilt a secondary source record is read with 
sequence higher than <HIGH SEQUENCE>. Note: VOID 
presumes $MERGE. : 


Prefacing an option with NO turns it off. For instance NO LIST stops 
Listing of source records till $LIST is encountered. NO has no 


effect on VOID and LIBRARY. 


Defaults--alt options are off except LIST» CHECK» and OOUBLE. 


Stack sizes are listed at the end of the compiler run and should 
suffice for normal operation» but may be increased if stack 
overflow occurs or decreased to tune to minimum memory requirements 


for special reasons. 
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- BURROUGIS CORPORATION 
© COMPUTE? SYSTEMS GROUP 
SANTA BARBARA PLANT 


RES: RVED WORDS 


use 


in the NDL syntax. 


 ACCZSSERR 


The following words may not be used as identifiers because of their 


) DISCONNECT LENGTH — RESULTDESC 

: ACU DISPLAY LINE RETRY 

| ADD=RR DO LOGICALACK RETURN 

| ADDRESS DUMMY LOGIN SCREEN 

| AND DUMP LOSSOFCARRIER SEC 

: ASC53 EBCDIC LOSSOFOSR SECURITY 

: ASC54 ELSE LT SEQUENCE 

: —ASCIB END MA X SIGNAL 

: AUDIT ENDOF BUFFER MAXINPUT SPECIAL 

AUDITFILE © £4 MAXINWORK SPO 

AUT JANSWER | ERROR MAXOUTWORK STATION 

AUTIJPOLL EVEN | MAXSTATIONS STORE 

| BREAK EXCEPTION MC SQUEUE SUM 

BUFFER FALSE MEMORY TALLY 

CAL. FAMILY MIN TASK 

A CANTZEL FETCH MODE TERMINAL 

CARI IAGE FILE MYUSE TERMINALT YPE 

CAS: FINI NE TERMINATE 

— CHAR FINISH NIF TEXT 

CHARACTER FOR. NORMAL THEN 

| CLEAR FORMAT NO. TIME 
COD: FORMATERR NOT TIMEOUT 
COMMENT FREQUENCY NULL TO 
CONSTANT «GE O00 TOG 
CONTINUE GT OR TRACE 
CONTROL ~ HEADER OUTPUT TRAN 
CONTROLLER HORIZONTAL —OUTPUTATTACHED TRANERR | 
CONVERT | IOLE PAGE TRANSMISSION 

JEBIG IF PARITY TRANSMIT 

DECIMAL INCREMENT PASSIVE TRUE 

| DECLARATION INITIALIZE PHONE TURNAROUND 

| DECREMENT INITIATE POLL TYPE 

DEFAULT ~ INPUT RECEIVE UNDO 

| DIAGNOSTIC INPUTATTACHED REMOTE USER 

DIALIN IODESC REQUEST VERTICAL 

j DIA_OUT LE | 


Es SDR SESE aE SS a eS Rae Pe Pec St ee te SE Ne ee ee ee 


3G PER es SE Pe es 
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RUNNING AN NDL CONTROLLER * 


*Sectior will be completed at a later date. 
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MEMORY» STACK SIZES 


Memory Required 


4. «6BASIC SYSTEM SOFTWARE in Bytes. 


= —_ an 7 am em OO 
mm 7m om oa a ae 


System static memory (MCP stacks» MCP zeroe GISMD 7ZErOre CEC. deo ce 


Conditional static C(IOAT» CU Cede wncccsenaeeereeeeeeeneaseeveeee ae @ 
System dynamic memory 


MCP zero~page resident COdCrceeecccccerecscssrreccsceccrecees 4ef72 


MCP code for NOL/QUEVE/REMOTE“FILE GUDPOPE oe eeseseoreeersecrers 529594 


MCP code for QUEUE-FILES (required for active MCS) 


CONdItIONaleseccevesccccesseresesssessesessersrrcvascvscess 12893 


Subtotal 1 k tk ke ew aewoe 
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2. NOL eee 


Qasic 


=m om ap GR ew aw ow 


- required static + required code + SOL/INTERP segments. .-- 89137 


NOL tables and table~ related 
Lina: 272 *Cnumber (ines) oekeesieess = 
Station: 75 «(number stns tldecsscee = 
Terninal: 9 *(number terminals)e.-- = 
Fila: 13 *«€Cnumber FileS)oewccesnceee = 


Noe fapte SUMs cece ee ceacececeaceceesuestensnsecreesssseseeee” ciel oa ee cae. 


7 Requests. + Controls (See comoptlation) + LINK Seceeeeeeceeeneeceees 


Queues and Messages 
Queue Directories: 27 * Copen Q-files 
+ open remote Ffileslecceneccnsesen = 


NDL Input Buffers: sum of "MAXINPUT™ 


for all LINES s«ccceceeecneeseveenes a 


NOL Output Buffers: sum of average 
oatput text for all Linesececrcses = 


Re ae 
as 


Queaed Messages number * Caverage 
size text + BB dane cece caerccsoncns = 


mm a of a oe me 
eeneeeeeneeeee @ 


Queuwe Messages SUM ew ween ecenvnenenvneereneeaneeeeern en 
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NOL 


NOL 


CONDITIONAL ADDITIONS 


AG OO D0 UU bse, 6s esa a: a Sse OS ee Sa ele WSS 6 Sie oS Se Sines 4 eS ee ae SaN 598 


+ Sum autopoll buffers Call BC eee een 
Read no timeout CAutopoll>, TTY» RSE) ce we ween rere cncceccc rece 454 


TEL SCY POS cece cc ence serene sccaseseenneccessececcasasesececrens 130 


Audit - at PAG brates Gis a av So rw es ad as Ss SS ada Se 1-106. 


a if 2 or 3 AUDIT TLES cece rene ccc cccccesencccssanscsnaceces 362 
a PP PCONVER "24.656 es cere oueeeG cease ee eae eaten te sees 152 


+ if Fabs» buffers>, BUC ce-wiaes See ttewees os Geese eens see sces 
+ GISMO segments sequential LIT 6-66 Sow ee CS. SS OS AWS SOE OEE SS OSS 
enhanced LS sbi e566 SS ee Sw eS Oe oe 66S eee Mente pen oe ony ee 


i ee ee ee ere re eee eee Tee re ere ee eee 840 


Tra rsmisston number IncreMentaliOnss.curcccescrcccccceccsesces 164 


(not ARM character or 0/1 schemes) 
Conversational Line disciplines — at LeaSt.eocesecerccccccaace 273 


+ af "RECEIVE ADDRESS CSTATIONI™ 15 usedencennsececcerccens 220 


MCS - at LEAST ew ee ce cow c ener eece cc escsecccccererccescceccccnn 433 


+ af LOGICALACK 1S. USOC sees ssiwis/6 sco wip bes are es stare eieeers ose ais 828 


Conditional Addition SU Wicaiee Sb aioe eee abe oe ee sie 


subtotal 2: NDL basic + taoles + queues + conditional < £ * Sees ee= | 


2 SSG e AE aie DE ST Se te Eee tt Pe: epee tere ee eS es Be |W e 


FES Da oe aa ee bee Be Sh See 
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3. MCS» if any7 7 7 7 7 7 7 7 7 7 Subtotal 3:7 


4. USE2% PROGRAMS 


= = an ae ee ee ee ee ee Ee 8 


Including additonal interpreters» MCP support code 
(e.g. MICR> Random 1/0) <-Subtotal 4:-° - - - © 7 7 7 FB OT OT ME Sweee 


5. FUDSE FACTOR 


Leftover available» memory wasted in Link system + unknowns 


(required to provide non=thrashing system on real 1700 | 
a | : CWotoral. 226 oS Soe ee eee 2*000 


Add Subtotals 1-5. The sum is the minimum amount of 
5S memory to hold the NOL system working set. TOTAL....======= 


STOPPING 


JEBIGGING 


DEBUGS 


™ 72 =: aD = 


Ge Oe NS 2 AL SS 8 a ee i a ee 


13-6 


BURRDUGIS CORPORATION | | COMPANY CONFIDENTIAL 


COMPUTE? SYSTEMS GROUP B1700 NETWORK DEFINITION LANGUAGE 
SANTA BARBARA PLANT Pe Se 2212 5223 
10L0G 


The [9LIG function provi des for monitoring of alt datacomm [0 
activity through an external disk file labetled "DC"™/"AUDIT.~FILE™. 
A program "DC"/™AUDIT™ wilt read this file either in parallel with 
NOL or subsequently» formatting the information to the user's needs 
(See documentation on DC/AUDIT). : 


To turn on IOLO0G:. 


Set DEBUG #28 in DBCARDS or type in <CONTROL MIX 
NUM3ER> AXLOLOG on SPO. To turn off [OLOG»s Just 
rep2at the process: <CONTROL MIX NUMBER> AXIOLOG. A 
message will appear on the SPO indicating whether 
[0LJG was turned on or off and the date and time. 


If DC/AJDIT-FILE Its missing» a new file is created. A header 
provides information to "OC"/"AUDIT™ indicating the first record 
written by this job Cirrelevant of turing I9L0G off and on 
subsequantly)» the next record to be writtens and the total records 
written. The file wraps around on itself» so that more records may 
be written than are accounted for in the AUDIT file. The size of 
the fite is determined dynamically. If the fite 1s In use by 
another handler» a SPO message will so indicate. “3 | 


A comment record is atways the first record to be written each time 
IO0LOG 1s set on. | | 


«Section will be completed at a tater date. 


BURROUGA 


SANTA BA 


118 

119 

120 
1249125» 
1269127>» 
1282136 
1290134 
1350 | 
131 . 
1329133 
155 

142 

143 


144 
145 


146 
148 


149 
150 


COMPUTER 


Poll pointer ts 


Tried to receive 


S CORPORATION 
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RUNERRORS 
RUN ERROR LIST 
Reason 


Parity Error 
Invalid station index returned by autopoll. 
DCWRITE error on present communicate. 

MACRO incompatible with the MCP. 

Initiate receive but no buffer. 

No poll List. 

No autopoll buffer or Length ZerO« 

Invalid DCWRITE while queing input. | 
Invalid DCWRITE while queing error message 
or station not enabled for input. 
Receive text or terminate echo with no 
buffer or no text. 

Beginning of text misaligned. 
Transmit exceeded end of buffer. 
Invalid DCWRITE while returning open 


input 


message. 
Invatid NIF file. 


Network is too large. 


Main control loop exited. 
Invatid address file. 


Table size is too small. 

Station is invalid. 

Transmit text but no buffer. 

Station cannot be polled or string size does 
not agree with previous entry. 

invalid. 

Length of poll list is greater than 120 
Ccharacterse | | 

Invalid open text size length 

Message in station queue has length zero. 


Station attached to another line. 


input after shutdown started. 
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Error Originator 


Memory 
Controttler: 
Controller. 
Controttler 
NDL Code 
NOL Code 
NDL Code 
Controller 


Controller 
NOL Code 


NOL Code 
NDL Code 


Controller 


Compiler 


Controtler 
Controller 
Controller 
Compiler 
NOL Code 
NOL Code 


NOL Code 
Controttler 


NDL Code 
MCP 
MCP or 


User Program 


Controller 
NDL Code 
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151. Invalid DCWRITE while queing EUF for USER. 

PROGRAM | Controller 
152 Transmit string is not MOOS bits. NOL Code 
170 Message length is zero. | MCP 
177 MCS message found but not expected. MCP 
180 - Request definition is missing or wrong. NDL. Code 
190 Invalid initiate. | NDL Code. 
191 Control changed state to a different request. NDL Code 
192 Station cannot be changed. © NDL. Code 
193 Line has a station not in station Liste. Controller 


USING AN MCS * 


*Sectior will be completed at a later date. 


ee ae ae en a eg ae re nee ae A eT ILE pr a A AER Re eee FOND LOO as SIMON Clg” yee ig So e . ei ee! 
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NOL UM? 


NOL/OUM? is a SOL program used for analyzing dump files created by 
MCP Ve-0 of the MACRD V.0. This analysis gives the NDL programmer 
information regarding his system status variables» his’ present 
network configuration and his Lines» stations and terminals status. 
The dumo analysis also contains information regarding the status of 
the MAZRO» which ts transparent to the NOL user. This information 


can be used to debug the MACRO. 


This dozument is for helping an NDL programmer understand the dump 
analysis. It 1s not however» for explaining how the MARCO works to 
an NDL usere Consequently the explanation of some variables is 


omitted. 


OPERATION 


Given a dump file named DUMPFILE/<NUMBER>» to use NDL/DOUMP enter 
PM <NUMBER> ANC 


on the SPO. This command will start up NOL/DUMP. On EQJ» the dump 


file with not be removed. 


If the dump file is not made of the MACRO or is of a MACRO of a 
wrong level or some essential constant(s) Ce-ge PPBPTR) are 
Incorrect»  NDOL/DUMP will terminate prematurely indicating that the 


dump file was not valid. 


Tnere are a number of formats which are used to print the various 


data items of the MACRO. In generals, the obvious interpretation 
should 3e correct. 7 | ~ 


BURROUGIS CORPORATION COMPANY CONFIDENTIAL 
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DECIMAL. 


ALt data items which are bit(24) or less and are not 
address2s are printed as decimal numbers. Fixed fietds 
printed ‘as decimal numbers» but they are oreceeded by a 


HEX 


absolute 


are also 
"4" or a 


- 


ALl data items which are surrounded by *a" signs are printed in hex. 


CHARACTER 


ALL character fietds which contain valid characters are printed as 
they ares character fields which contains invalid character(s) are 


printed in hex. 


ASCII 


Datacomn buffers are printed in this format. In this 
printable character is printed as itself and an invalid 
is printed vertically in hex. For examples the string: 


a01C1F102C1C2C 303a 


is printed as: 


~ 9A10ABCO 
12 3 


format a- 
character 
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SPECIAL FORMATS 


ALL 20 dit data items which contain the time of day in tenths of 
seconds are printed in standard HH?MM:55 format. _ 


The fields of LINE-TYPE and LINE.STATUS are interpreted. 


Debug bo20leans are printed by name when set. 


en a a a a ee eS a a a ee a 


re es Se ee 


DUMP ANALYSIS DIVE ENE 


The following is an outline of the output of NOL/DUMP. Note that the 
Last three items are printed only when applicable. 


1. Header page 
i : 2. Global data items 
7 | 3e Terminal tables 
| 4. Station tables 
©} | 5- Line tabodles 
6. Queue headers. 
| | 7. Active CONTROL or REQUEST 
8. Local variables 


The MACRO version data is obtained from the NIF. If the NIF is not 

presente this date field wilt be printed as blanks. If the NIF 
indicat2s that the MACRO Level is not compatible with. NOL/ DUMP.» 
then anerror message is printed out and NDOL/DOUMP will terminate. 
The other parameters in this page are obtained from the PP8. 


GLO3 AL VARTABLES. 


a ‘The gloxat variables are printed out in order of their declaration 


14-4 


BURRDUG4IS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | B1700 NETWORK OEFINITION LANGUAGE 
SANTA BARBARA PLANT PeS.- 2212 5223 


TABLE INDEXING 


The network description as specifed by an NOL program is stored in 
the MACWO tables. These tables are declared as one data item in the 
MAINeCONTROL procedure of the MACRO. The information tan these 
tables is accessed by using indexing. The global variables L.eI»s» S.I 
and Tel are respectively the line table index» station table index 
and terminal table index. The terminal tables are stored 
sequentially starting at the index TERMINAL-TABLE-FIRST Ca global 
vartable2). There are MAX.TERMINALS terminal tables. Simttary 
STATIONe TABLE-FIRST C(LINE-TABLE-FIRST) and MAXeSTATIONS (MAX-LINES) 
indicat2 the number and starting’ index of the station (Cline) 
tables. | | 


NOL/JUM? prints out the’ terminal tables first followed by the 
station tables followed by the Line tables. All references to these 
tables are done through the index. In other words» the index of the 
table of the third line identifes that Line. A tabte index 15 
always printed in decimal. | | 


If any debug booleans are set or debug table has a non-zero entry» 
the aopropriate name of the debug boolean will be printed out In 
the gloosal variable section. These booteans are printed out between: 
FILE~RESEDENT and HOR.OCW. 


MAC20 TABLES 


The MAC2?0 tables are printed in the = order described tn TABLE 
INDEXING. The. entries tn these tables are either status indicator 
or system constants set Dy NDL. In section NOL*MACRO VARIABLES 
XREF» the cross~reference between NOL and the MACRO is presented. 
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TABLE HEADER 


Each taale has a header of the following format: 


ie * TERMINAL | 
| STATION TABLE <NUMBER> C<IDENTIFER>] <INDEX> 
| : | 

LIN . 


The Lina table has in addition below the headers the hardware 
address of this particular line. This address 1s orinted in the 
fotlowing format: | | 


port. channel adapter 


t 
oe 


| 
| number number number 


Ihe identifier in the header is the actual NDL source name for the 
Line station or terminal to which the table is referring to. Ihis 
| identifier is obtained from the NIF. If the NIF 1s not present 
during execution of NDL/DUMPs blanks are put in place of the 
identifier. The index in the header is the indexed described In 


@ se LVDEXING. 


STATION QUEUE HEADER 


Lf a station has an active queues its header wilt be printed out 
after the station TALLYS and TOGGLES. The format of the header 15 
descrio2d in QUEUE HEADERS. | 


LINE WORK AREAS AND ee 


For each Line» the input and output work areas poll list» and input 
and output buffers Cif present) are printed out in ASCII format at 


‘the end of each tine table. 


aed: eT ee en ee eee te ee a awe ty Pee 


Pe Eg ee ee A eg ge Eee a ee Oe Te ee ee Ee ee ee a Te en, 5a A a aaa a cal a 
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THE STATION ACTIVE ON A LINE 


To find the station attached to a given line at dump time» use the 
foltowing formula: 


index=STATIONLISTCFIRST «STATION«NO+LINE «CURRENT. STATION.NO-1) 


This index identifies the desired station. 


GENZRAL INFORMATION 


This s2ction of the dump analysis is optional-~-it is only printed 
when the information needed is present. 


QUEUE HEADERS 


When actives the following queue headers are going to be printed 
out: | | 

1. General input queue 

2- General output queue 

32 MCS queue | 

4. Control queue 
The fornat of these headers is as follows: 


JQ.HEADA Q.FAMILY.NAME/Q.OFFSPRING.NAME 2Q.TAIL@ Q.USER.COUNT 
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CONTROL AND REQUEST NUMBERS 


I f the NOL program has an active CONTROL or an active REQUES Te» the 
dump analysis will indicate the number of such a control and/or 
request. This number is a index to the order in which the controls. 
or requasts are declared. For example» the first request in the NOL 
program is numbered 1. 


LOCAL VARIABLES 


The Local variables of alt procedures that are envoked after the 
|  MAIN-CONTROL procedures are printed out at the end of the dump 
| analysis. | 


PROCEDURE HEADER FORMAT 

| Fach procedure's data items is preceeded by the header of the 

| following format: | 

EXITED -EXIC LEVEL <number>-ENTERED LEXIC LEVEL <number>l<procedure name>] 


| Note that the procedure name is an option which depends on whether 
: the NMP?C conditional compile is set for the MACRO compile. 


DATA ITEMS FORMAT 


The fornat of the Local data items 1s as follows: 
<Data Type> <pit Length> (Cdecimal value)] <value> 


The decimal vatue is printed if <bit ltength> is less than or equals 
24-2 The value is printed in hex untess <data type> equals CHARACTER 
and value has valid characters. In this case <value> 1s printed out 
directly. 
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NDL=MACRO VARIABLES XREF 


This cross reference is by no means a complete map between the 
MACRO*s variables and NOL. [t is ment to be helpful to the NDL 
programner who ts not familiar with the MACRO Inner works. 


SYSTEM STATUS VARTABLES © 


NOL System Status NDL/DUMP Section MACRO Variables Special 


Variables Names (See Outline 4.0) Names Notes * 
CHARACTER LINE TABLE LINE.«CHAR.BUFFER = 
FREQUENT YCINPUT) STATION TABLE INPUT.~PRIORITY | 
FREQUENC YCOUTPUT) STATION TABLE OUTPUT.PRIORITY 
TJDESC LINE.TABLE IO0.DESCRIPTOR #1 
INPUTATTACHED LINE.-TABLE INPUT.BUFFER.VALID 
QUTPUTAT TACHED LINE.TABLE OUTPUT.BUFFER.VALID 
LENGTHCINPUT) LINE.TABLE INPUT.BUFFER.LENGTH 

. LENGTHCJUTPUT) - LINE.TABLE oe DCW. SIZE 
@ vine LINE. TABLE NUMBER 
~ LEINECCONTROL KEY) LINE. TABLE CONTROL. KEY 

LINE CQUZUED) LINE. TABLE QUEUED , #2 
MAXSTATIONS 7 LINE. TABLE MAX.STATIONS 
RESULTD=SC . LINE»TABLE [0.REQUEST #3 
RETRY | STATION TABLE RETRY. COUNT 
STATION | LINE.~TABLE LINE.CUR.STATION.NO 
STATIONCENABLED) STATIIN TABLE ENABLED 
STATIONCMYUSE) STATION TABLE MYUSE 
STATIONC QUEUED) GLOBAL ARRAY STATION. Q © | #4 
STATIONCREADY) STATION TABLE READY 
STATIONC TYPE) STATION TABLE CONTROL-LINK AS 
STATLONCVAILD) STATION TABLE | VALID 
TERMINA_ TYPE TERMINAL TABLE TYPE 
TIME from MCP saa ol 
TRANCREZEIVE) | STATION TABLE INPUT. TRAN.~NO 
TRANCTRANSMIT) | STATION TABLE OUTPUT. TRAN.NO 
ERROR FLAGS GLOBAL VARTABLE | DESCRIPTION. ERRORS Ho 
TOGE<INJEX>) STATION TABLE STATION TOGGLES 
LINECTOGL<INDEX>]) LINE.FABLE LINE TOGGLES 
TALLYC <I NDEX>] STATION TABLE | STATION TALLYS 
LINECTA.LYC<INDEX>1) LINE.~TABLE LINE TALLYS 


TIMECTA_LY) : STATION TABLE TIME.TALLY 
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«SPECIAL NOTES: 


1. Part of the first two descriptiors is stored in 
this field. Each of these parts consists of the 
following consecutive 24 bit fields: 


IO-.ACTUAL -END 
I0-RESULT 
IO0.LINK 

10.0P 
I0.BEGIN 
JO.END 


2 If this field is greater than QO» the QUEUED has 
a value of trues otherwise QUEUED 1s false. 


36 This fietd is a concatination of the LD.-RESULT 
fields of the first two IOD0.-DESCRIPTOR fields. 


4. If this field is greater than 0» STATIONCQUEUED) 
is trues otherwise STATIONCQUEUED) is false. 


De The following are the possible values and 
corresponding meanings of this field. 


a0a means NORMAL. 
aFQa means CONTROLLER 
anything else means SLAVE 


oa The specific error fiags are bits o f 
| RESULT .DESCRIPTOR: 


Bit 1: PARITY Bit 7 : LOSSOFODSR 
Bit 2 : ACCESSERR Bit 8 =: LOSSOFCARRIER 
Bit 3 : Not used Bit 9 3: ADDERR , 
Bit 4 : TIMEOUT Bit 10: TRANERR 
Bit 5 =: READ Bit 11:2: FORMATERR 
Bit 6 : ENDOFBUFFER Bit 12: Not used 

Bit 13: EXCEPTION 


oa ; SE ei ot ar ane x Sie - a — DIE ese ete oe ee aE ee meee AFT pe ge pcp ee Ail eth daa ie ond rod tear tog nate tbat gee RE Matt aE GEM EEE Wan eee ay ee ee eg ss = 


BURROUGIS CORPORATION 
COMPUTE? SYSTEMS GROUP 
SANTA BARBARA PLANT 


TERMINAL SECTION 


IDENTIFIER 

4EADER SIZE 
MAXINPUT ADDRESS 
YIAGNOSTIC Reese 
REQUEST 

TYPE 

TRANSMEISSTON NUMBER 
ADDRESS 


STATION SECTION 


[DENTIFIER 
SONTROLLER 
= RE QUENCY 
~OGICALACK 
MCS QUEUED 
MYUSE 
ADDRESS 
TERMINAL 
RETRY 


LIN: SECTION 


ee ae ee ee a a a am 


maa a hoo oe oe an cn ap an on on am oe oe 


IDENTIFIER 
AUTOPOLL SIZE 
ADDRESS 
>ONTROL © 
STATION 

TYPE 

MAX INWORK 
MAXOUTWORK © 
MAXSTATIQNS 
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NDL/DUMP Terminal Table Variable 


me maa ee ee ee ee eee ee ee ee ee ee ee ee) ee oe OP ee ee ae ee) ee a at em ; 


Table Identifier 


HEADER. SIZE 


INPUT.MAX.MSG 

DIAG. OUTPUT. REQUESTC(DIAG. INPUT. RE QUEST) 
OUTPUT. REQUESTCINPUT. REQUEST) 

TYPE 

NO.SIZE 

QUTPUT. ADRS.~SIZECINPUT.ADRS.SIZE) 


NDL/DOUMP Station Table Variable 
Table identifier 

CONTROLLER 
INPUT.-PRITORITYCOUTPUT.PRIORITY) 
LOGICAL.ACK oa 
MCS.~EXPECTED (this is a global variable) 
MYUSE | | 
INPUT~-ADDRESSCOUTPUT.ADDRESS) 
TERMINAL.LINK 

RETRY.~COUNT — 


NOL/DUMP Line Table Variable. 


Table Identifier 


POLL.~LIST~LENGTH 
Port:Channel:zAdapter 
CONTROL.LINK 
STATTON.LINK 

TYPE 

INPUT.~WAe~LENGTH 
OUTPUT.WAeLENGTH 


—MAXeSTATIONS 
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FILZ SECTION 


The arrays in the global section contain information regarding which 


station betong to which family. The following is a method to find 
this information. | 


1. Look in FILENAME array for the family name. 


2 e Get the index into this array which points to the 
given family name. This is the family number. 


L The station number is the index into the station 
identifier list in the NOL family statement. Note 
that this index starts with 0 value. 


4 e FILE.~-STATION-LIST.PTR (family number + station 
number) ts your station pointer. 


Se FILE«STATION.LIST (station pointer) is the 
| Station list pointer. | : 


6. STATION-LIST (station tist pointer) is the index 
Into the station table. | 


